Nearby Search

An MCP server for nearby place searches with IP-based location detection.

python

22

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kukapay-nearby-search-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/nearby-search-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "GOOGLE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

NearbySearch MCP Server provides an MCP endpoint to search for nearby places using your current IP-derived location, leveraging Google Places for results. It’s useful when you want quick, location-aware place suggestions without manual input of coordinates.

How to use

You interact with NearbySearch through an MCP client. Start the server in development mode to test with the MCP Inspector, or install it into your environment to run as a standard MCP service. Use the built-in endpoint to search for places by keyword, with optional radius and type filters.

Key endpoint you’ll use: search_nearby. Provide a keyword like coffee shop and optionally adjust the radius in meters (default 1500) and narrow results with a type such as restaurant or cafe. The server automatically determines your location from your IP address. Ensure you have a valid Google API Key with Places API enabled.

How to install

Prerequisites you must have installed before running the server:

Python 3.10 or newer

Google Cloud Platform API Key with Places API enabled

Internet access

Install the runtime and dependencies using either uvx (recommended) or pip

# Using uv (recommended)
uv add "mcp[cli]" httpx python-dotenv

# Or using pip
pip install mcp httpx python-dotenv

Similar commands you will run to start and manage the server

mcp dev main.py

mcp install main.py --name "NearbySearch"

python main.py

Configuration you need to provide

Set up your client configuration to run the MCP server locally with the required environment variable for the Google API key.

{
  "mcpServers": {
    "nearby-search": {
      "command": "uv",
      "args": ["--directory", "path/to/nearby-search-mcp", "run", "main.py"],
      "env": {
        "GOOGLE_API_KEY": "your google api key"
      }
    }
  }
}

Available guidance for usage patterns

To search for places near your location, call the endpoint with a keyword and optional parameters: keyword for the search term, radius for how far to search, and type to filter by place category. The default radius is 1500 meters if you omit it.

Available tools

search_nearby

Endpoint that searches for places near the current IP-derived location using a specified keyword and optional radius and type filters.