Nearby Search MCP

🚀 Nearby Search MCP Server

A Nearby Search MCP Server that detects location based on IP addresses.

🚀 Quick Start

The Nearby Search MCP Server is a powerful tool that detects your location via IP addresses and searches for nearby places. It integrates with Google Places and provides a simple interface for easy use.

✨ Features

• IP Address Location Detection: Determines the current location using ipapi.co.
• Google Places Integration: Searches for nearby places based on keywords and optional types.
• Simple Interface: A single tool endpoint with a custom radius option.

📦 Installation

Prerequisites

• Python 3.10+
• A Google Cloud Platform API key with Places API enabled
• Internet connection

Steps

1. Clone the repository:

git clone https://github.com/kukapay/nearby-search-mcp.git
cd nearby-search-mcp

2. Install the dependencies:

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

# Or using pip
pip install mcp httpx python-dotenv

3. 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 Examples

Running the Server

Basic Usage

• 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 nearby places based on the current location.
• Parameters:
  • keyword (str): The content to search for (e.g., "café").
  • radius (int, optional): The search radius in meters (default: 1500).
  • type (str, optional): The type of place (e.g., "restaurant", "café").

📄 License

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