NearbySearch MCP Server logo

NearbySearch MCP Server

by kukapay

An MCP server designed for searching nearby places using IP-based location detection. It integrates with Google Places API to find places based on keywords and optional type filters.

View on GitHub

Last updated: N/A

What is NearbySearch MCP Server?

The NearbySearch MCP Server is a tool that allows users to find nearby places based on their IP address. It leverages the ipapi.co service for location detection and the Google Places API for searching.

How to use NearbySearch MCP Server?

To use the server, you need to clone the repository, install the necessary dependencies (mcp, httpx, python-dotenv), configure the Google API key, and then run the server using MCP in development mode, install it in Claude Desktop, or execute it directly with Python. You can then use the search_nearby tool endpoint with parameters like keyword, radius, and type to find places.

Key features of NearbySearch MCP Server

  • IP-based Location Detection

  • Google Places Integration

  • Simple Interface

  • Customizable Search Radius

Use cases of NearbySearch MCP Server

  • Finding nearby restaurants

  • Locating coffee shops in an area

  • Discovering different types of businesses nearby

  • Integrating location-based search into applications

FAQ from NearbySearch MCP Server

What is the default search radius?

The default search radius is 1500 meters.

What Python version is required?

Python 3.10 or higher is required.

Do I need a Google API key?

Yes, a Google Cloud Platform API key with the Places API enabled is required.

How does the server determine my location?

The server uses ipapi.co to determine your location based on your IP address.

What if I don't have MCP installed?

You can install MCP using pip install mcp or uv add mcp.