nearby-search-mcp

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

  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.

-
security - not tested
A
license - permissive license
-
quality - not tested

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.

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

  1. Features
    1. Requirements
      1. Installation
        1. Usage
          1. Running the Server
          2. Available Endpoints
        2. License

          Related MCP Servers

          • -
            security
            A
            license
            -
            quality
            This MCP server provides access to TripAdvisor data for planning vacations, enabling users to search for and get details about locations, attractions, restaurants, and hotels through an interactive planning experience.
            Last updated -
            1
            Python
            Apache 2.0
            • Linux
            • Apple
          • A
            security
            A
            license
            A
            quality
            A Model Context Protocol server that retrieves detailed geographic information about IP addresses using the ipinfo.io API, helping determine user location and network details.
            Last updated -
            1
            5
            Python
            MIT License
          • -
            security
            A
            license
            -
            quality
            A lightweight mcp server that tells you exactly where you are.
            Last updated -
            Python
            MIT License
          • -
            security
            -
            license
            -
            quality
            An MCP server that enables querying detailed address information from Brazilian postal codes (CEPs) via the ViaCEP API, returning data such as street names, neighborhoods, cities, states, regions, and IBGE codes.
            Last updated -
            TypeScript
            MIT License

          View all related MCP servers

          ID: uz39j7nvm8