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

Related MCP server: MCP Hub Tools

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")