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
- Clonar el repositorio:
git clone https://github.com/kukapay/nearby-search-mcp.git
cd nearby-search-mcp
- Instalar dependencias:
# Using uv (recommended)
uv add "mcp[cli]" httpx python-dotenv
# Or using pip
pip install mcp httpx python-dotenv
- 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):
- Instalar en Claude Desktop :
mcp install main.py --name "NearbySearch"
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.