-
securityA
license-
qualityA lightweight mcp server that tells you exactly where you are.
Last updated -
3
MIT License
Integrates with Google Places API to search for nearby places based on keywords, with options for radius customization and type filtering.
Uses Google Cloud Platform API Key with Places API to perform location-based searches for nearby points of interest.
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:
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.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
An MCP server for nearby place searches with IP-based location detection.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server that allows searching for and retrieving information about Model Context Protocol servers registered on the MCP Hub.Last updated -11MIT License
- AsecurityAlicenseAqualityIP Geolocation MCP server using IP2Location.io API to ease the query of geolocation information.Last updated -111PythonMIT License
- -securityFlicense-qualityA MCP server that uses Amap API to provide location-based services, allowing users to get geographic information based on IP addresses and search for nearby points of interest.Last updated -13