NearbySearch MCP Server

1# NearbySearch MCP Server
2 
3An MCP server for nearby place searches with IP-based location detection.
4 
5![GitHub License](https://img.shields.io/github/license/kukapay/nearby-search-mcp) 
6![GitHub Last Commit](https://img.shields.io/github/last-commit/kukapay/nearby-search-mcp) 
7![Python Version](https://img.shields.io/badge/python-3.10%2B-blue)
8 
9## Features
10 
11- **IP-based Location Detection**: Uses ipapi.co to determine your current location
12- **Google Places Integration**: Searches for nearby places based on keywords and optional type filters
13- **Simple Interface**: Single tool endpoint with customizable radius
14 
15## Requirements
16 
17- Python 3.10+
18- Google Cloud Platform API Key with Places API enabled
19- Internet connection
20 
21## Installation
22 
231. Clone the repository:
24```bash
25git clone https://github.com/kukapay/nearby-search-mcp.git
26cd nearby-search-mcp
27```
28 
292. Install dependencies:
30```bash
31# Using uv (recommended)
32uv add "mcp[cli]" httpx python-dotenv
33 
34# Or using pip
35pip install mcp httpx python-dotenv
36```
37 
383. Client Configuration
39 
40```json
41{
42  "mcpServers": {
43    "nearby-search": {
44      "command": "uv",
45      "args": ["--directory", "path/to/nearby-search-mcp", "run", "main.py"],
46      "env": {
47        "GOOGLE_API_KEY": "your google api key"
48      }
49    }
50  }
51}
52````
53 
54## Usage
55 
56### Running the Server
57 
58- **Development Mode** (with MCP Inspector):
59```bash
60mcp dev main.py
61```
62 
63- **Install in Claude Desktop**:
64```bash
65mcp install main.py --name "NearbySearch"
66```
67 
68- **Direct Execution**:
69```bash
70python main.py
71```
72 
73### Available Endpoints
74 
75**Tool: `search_nearby`**
76 - Searches for places near your current location
77 - Parameters:
78   - `keyword` (str): What to search for (e.g., "coffee shop")
79   - `radius` (int, optional): Search radius in meters (default: 1500)
80   - `type` (str, optional): Place type (e.g., "restaurant", "cafe")
81 
82 
83## License
84 
85This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
86