NearbySearch MCP Server

What is NearbySearch MCP Server?

NearbySearch MCP Server is an MCP server that enables nearby place searches by combining IP-based location detection (via ipapi.co) with Google Places API. It serves users who need quick, location-aware search capabilities within MCP environments like Claude Desktop.

How to use NearbySearch MCP Server?

Clone the repository, install dependencies (mcp, httpx, python-dotenv) using uv or pip, and configure your client with a GOOGLE_API_KEY environment variable. Run the server in development mode with mcp dev main.py, install it in Claude Desktop with mcp install main.py --name "NearbySearch", or execute directly with python main.py. The sole tool endpoint, search_nearby, accepts a keyword string, an optional radius in meters (default 1500), and an optional place type such as "restaurant" or "cafe".

Key features of NearbySearch MCP Server

• IP-based location detection using ipapi.co
• Google Places integration for nearby searches
• Single tool endpoint with customizable radius
• Optional type filter for place categories
• Configurable search radius (default 1500 meters)

Use cases of NearbySearch MCP Server

• Finding coffee shops near your current location
• Searching for restaurants within a specified radius
• Locating nearby cafes, parks, or other place types
• Integrating location-aware search into MCP-enabled applications

FAQ from NearbySearch MCP Server

What are the requirements to run NearbySearch MCP Server?

Python 3.10 or higher, a Google Cloud Platform API key with Places API enabled, and an internet connection.

How do I install NearbySearch MCP Server?

Clone the repository, install dependencies (using uv or pip: mcp, httpx, python-dotenv), then configure your client with the GOOGLE_API_KEY environment variable.

How do I run NearbySearch MCP Server?

You can run it in development mode with mcp dev main.py, install it in Claude Desktop with mcp install main.py --name "NearbySearch", or execute directly with python main.py.

What parameters does the search_nearby tool accept?

Keyword (required string), radius (optional integer in meters, default 1500), and type (optional string, e.g., "restaurant" or "cafe").