https://github.com/kukapay/nearby-search-mcp
An MCP server for nearby place searches with IP-based location detection.
https://github.com/kukapay/nearby-search-mcp
Last synced: 28 days ago
JSON representation
An MCP server for nearby place searches with IP-based location detection.
- Host: GitHub
- URL: https://github.com/kukapay/nearby-search-mcp
- Owner: kukapay
- License: mit
- Created: 2025-03-16T22:33:20.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-03-16T22:37:28.000Z (about 1 month ago)
- Last Synced: 2025-03-16T23:28:33.411Z (about 1 month ago)
- Language: Python
- Homepage:
- Size: 0 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-list - kukapay/nearby-search-mcp - search-mcp?style=social)](https://github.com/kukapay/nearby-search-mcp): Enables nearby place searches using IP-based location detection. (Uncategorized / Uncategorized)
- awesome-mcp-zh - kukapay/nearby-search-mcp
- awesome-mcp-servers - kukapay/nearby-search-mcp - An MCP server for nearby place searches with IP-based location detection. (Legend / 🗺️ <a name="location-services"></a>Location Services)
- awesome-mcp-servers - kukapay/nearby-search-mcp - An MCP server for nearby place searches with IP-based location detection. (Legend / 🗺️ <a name="location-services"></a>Location Services)
- awesome-mcp-servers - Nearby Search Server - An MCP server for nearby place searches with IP-based location detection. (Table of Contents / Location Services)
- awesome-mcp-servers - Nearby Search Server - An MCP server for nearby place searches with IP-based location detection. (Table of Contents / Location Services)
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
1. Clone the repository:
```bash
git clone https://github.com/kukapay/nearby-search-mcp.git
cd nearby-search-mcp
```
2. Install dependencies:
```bash
# Using uv (recommended)
uv add "mcp[cli]" httpx python-dotenv
# Or using pip
pip install mcp httpx python-dotenv
```
3. Client Configuration
```json
{
"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):
```bash
mcp dev main.py
```
- **Install in Claude Desktop**:
```bash
mcp install main.py --name "NearbySearch"
```
- **Direct Execution**:
```bash
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](LICENSE) file for details.