About kukapay/nearby-search-mcp
kukapay/nearby-search-mcp is an MCP server published by kukapay in the Maps category: an MCP server for nearby place searches with IP-based location detection.
The repository has 22 stars and 6 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/kukapay/nearby-search-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about kukapay/nearby-search-mcp
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 2 hours ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
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.
README fetched from the repository 2 hours ago. The original is authoritative.