Back to Catalog
Python
Location
An MCP server for nearby place searches with IP-based location detection.
MCP Trust Score
Based on our comprehensive evaluation criteria
🤖 Evaluated by gemini-2.5-flashFix
Trust Score42/100
- • Basic MCP protocol features implemented (12/40)
- • Room for improvement in GitHub community
- • Optimal dependency management (20/20)
- • Room for improvement in deployment maturity
- • Documentation (8/8)
- • Archestra MCP Trust score badge is missing
GitHub Metrics
Repository statistics and activity
⭐ GitHub Stars:12
👥 Contributors:1
📋 Total Issues:4
📦 Has Releases:No
🔧 Has CI/CD Pipeline:No
Configuration
Configuration example extracted from README.md for Claude Desktop and other clients.
🤖 Evaluated by gemini-2.5-flashFix
{
"nearby-search": {
"command": "uv",
"args": [
"--directory",
"path/to/nearby-search-mcp",
"run",
"main.py"
],
"env": {
"GOOGLE_API_KEY": "your google api key"
}
},
"nearby-search-dev": {
"command": "mcp",
"args": [
"dev",
"main.py"
],
"env": {}
},
"nearby-search-direct": {
"command": "python",
"args": [
"main.py"
],
"env": {}
}
}MCP Protocol Support
Implemented MCP protocol features
🤖 Evaluated by gemini-2.5-flashFix
Tools:✓
Prompts:✗
Resources:✗
Sampling:✗
Roots:✗
Logging:✗
STDIO Transport:✓
HTTP Transport:✗
OAuth2 Auth:✗
Dependencies
3 dependencies
Libraries and frameworks used by this MCP server
🤖 Evaluated by gemini-2.5-flashFix
README.md
NearbySearch MCP Server
An MCP server for nearby place searches with IP-based location detection.
Features
- IP-based Location Detection: Uses ipapi.co to determine your current location
- Google Places Integration: Searches for nearby places based on keywords and optional type filters
- Simple Interface: Single tool endpoint with customizable radius
Requirements
- Python 3.10+
- Google Cloud Platform API Key with Places API enabled
- Internet connection
Installation
- Clone the repository:
git clone https://github.com/kukapay/nearby-search-mcp.git
cd nearby-search-mcp
- Install dependencies:
# Using uv (recommended)
uv add "mcp[cli]" httpx python-dotenv
# Or using pip
pip install mcp httpx python-dotenv
- Client Configuration
{
"mcpServers": {
"nearby-search": {
"command": "uv",
"args": ["--directory", "path/to/nearby-search-mcp", "run", "main.py"],
"env": {
"GOOGLE_API_KEY": "your google api key"
}
}
}
}
Usage
Running the Server
- Development Mode (with MCP Inspector):
mcp dev main.py
- Install in Claude Desktop:
mcp install main.py --name "NearbySearch"
- Direct Execution:
python main.py
Available Endpoints
Tool: search_nearby
- Searches for places near your current location
- Parameters:
keyword(str): What to search for (e.g., "coffee shop")radius(int, optional): Search radius in meters (default: 1500)type(str, optional): Place type (e.g., "restaurant", "cafe")
License
This project is licensed under the MIT License - see the LICENSE file for details.
Resources
Add Quality Badge
Show your MCP trust score in your README
[](https://archestra.ai/mcp-catalog/kukapay__nearby-search-mcp)README.md
NearbySearch MCP Server
An MCP server for nearby place searches with IP-based location detection.
Features
- IP-based Location Detection: Uses ipapi.co to determine your current location
- Google Places Integration: Searches for nearby places based on keywords and optional type filters
- Simple Interface: Single tool endpoint with customizable radius
Requirements
- Python 3.10+
- Google Cloud Platform API Key with Places API enabled
- Internet connection
Installation
- Clone the repository:
git clone https://github.com/kukapay/nearby-search-mcp.git
cd nearby-search-mcp
- Install dependencies:
# Using uv (recommended)
uv add "mcp[cli]" httpx python-dotenv
# Or using pip
pip install mcp httpx python-dotenv
- Client Configuration
{
"mcpServers": {
"nearby-search": {
"command": "uv",
"args": ["--directory", "path/to/nearby-search-mcp", "run", "main.py"],
"env": {
"GOOGLE_API_KEY": "your google api key"
}
}
}
}
Usage
Running the Server
- Development Mode (with MCP Inspector):
mcp dev main.py
- Install in Claude Desktop:
mcp install main.py --name "NearbySearch"
- Direct Execution:
python main.py
Available Endpoints
Tool: search_nearby
- Searches for places near your current location
- Parameters:
keyword(str): What to search for (e.g., "coffee shop")radius(int, optional): Search radius in meters (default: 1500)type(str, optional): Place type (e.g., "restaurant", "cafe")
License
This project is licensed under the MIT License - see the LICENSE file for details.