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

Related MCP server: GeoIP MCP Server

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

2. Instalar dependencias:

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

# Or using pip
pip install mcp httpx python-dotenv

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