Nearby Search Mcp
What is Nearby Search Mcp
The nearby-search-mcp is an MCP server designed for searching nearby places using IP-based location detection.
Use cases
Use cases include finding restaurants, cafes, or other points of interest near a user’s current location, enhancing user experience in travel apps, and providing location-based recommendations.
How to use
To use nearby-search-mcp, clone the repository, install the necessary dependencies, configure your Google API key, and run the server using the provided commands.
Key features
Key features include IP-based location detection via ipapi.co, integration with Google Places for searching nearby locations based on keywords, and a simple interface with customizable search radius.
Where to use
Nearby-search-mcp can be used in various fields such as mobile applications, location-based services, tourism, and any platform requiring nearby place searches.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Nearby Search Mcp
The nearby-search-mcp is an MCP server designed for searching nearby places using IP-based location detection.
Use cases
Use cases include finding restaurants, cafes, or other points of interest near a user’s current location, enhancing user experience in travel apps, and providing location-based recommendations.
How to use
To use nearby-search-mcp, clone the repository, install the necessary dependencies, configure your Google API key, and run the server using the provided commands.
Key features
Key features include IP-based location detection via ipapi.co, integration with Google Places for searching nearby locations based on keywords, and a simple interface with customizable search radius.
Where to use
Nearby-search-mcp can be used in various fields such as mobile applications, location-based services, tourism, and any platform requiring nearby place searches.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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.
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
