nearby-search-mcp

by kukapay
Verified

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.

Servidor MCP de búsqueda cercana

Un servidor MCP para búsquedas de lugares cercanos con detección de ubicación basada en IP.

Características

  • Detección de ubicación basada en IP : utiliza ipapi.co para determinar su ubicación actual
  • Integración con Google Places : busca lugares cercanos según palabras clave y filtros de tipo opcionales
  • Interfaz sencilla : punto final de herramienta único con radio personalizable

Requisitos

  • Python 3.10+
  • Clave API de Google Cloud Platform con API de Places habilitada
  • Conexión a Internet

Instalación

  1. Clonar el repositorio:
git clone https://github.com/kukapay/nearby-search-mcp.git cd nearby-search-mcp
  1. Instalar dependencias:
# Using uv (recommended) uv add "mcp[cli]" httpx python-dotenv # Or using pip pip install mcp httpx python-dotenv
  1. Configuración del cliente
{ "mcpServers": { "nearby-search": { "command": "uv", "args": ["--directory", "path/to/nearby-search-mcp", "run", "main.py"], "env": { "GOOGLE_API_KEY": "your google api key" } } } }

Uso

Ejecución del servidor

  • Modo de desarrollo (con MCP Inspector):
mcp dev main.py
  • Instalar en Claude Desktop :
mcp install main.py --name "NearbySearch"
  • Ejecución directa :
python main.py

Puntos finales disponibles

Herramienta: search_nearby

  • Busca lugares cerca de tu ubicación actual
  • Parámetros:
    • keyword (str): Qué buscar (por ejemplo, "cafetería")
    • radius (int, opcional): radio de búsqueda en metros (predeterminado: 1500)
    • type (str, opcional): Tipo de lugar (p. ej., "restaurante", "cafetería")

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

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

Un servidor MCP para búsquedas de lugares cercanos con detección de ubicación basada en IP.

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