remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Integrates with Google Places API to search for nearby places based on keywords, with options for radius customization and type filtering.
Uses Google Cloud Platform API Key with Places API to perform location-based searches for nearby points of interest.

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

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: search_nearby

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

License

This project is licensed under the MIT License - see the LICENSE file for details.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

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

Related Resources

Reddit Discussion about this server

Appeared in Searches

A server for finding food outlets near me