JUHE API Marketplace
kukapay avatar
MCP Server

nearby-search-mcp

An MCP server for nearby place searches with IP

14
GitHub Stars
8/22/2025
Last Updated
MCP Server Configuration
1{
2 "name": "nearby-search",
3 "command": "uv",
4 "args": [
5 "--directory",
6 "path/to/nearby-search-mcp",
7 "run",
8 "main.py"
9 ],
10 "env": {
11 "GOOGLE_API_KEY": "your google api key"
12 }
13}
JSON13 lines

README Documentation

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

  1. Clone the repository:
git clone https://github.com/kukapay/nearby-search-mcp.git
cd nearby-search-mcp
  1. Install dependencies:
# Using uv (recommended)
uv add "mcp[cli]" httpx python-dotenv

# Or using pip
pip install mcp httpx python-dotenv
  1. 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.

Quick Install

Quick Actions

Key Features

Model Context Protocol
Secure Communication
Real-time Updates
Open Source