🗺️ MCP Google Maps - stdio Edition

Servidor MCP de Google Maps con soporte stdio para Claude Desktop

npm version License: MIT

🚀 Instalación

Instalación Global (Recomendada)

npm install -g @vicente-alvarado/mcp-google-map-stdio

Instalación Local

npm install @vicente-alvarado/mcp-google-map-stdio

⚡ Uso Rápido

1. Configurar API Key

Opción A: Variables de entorno

# Windows set GOOGLE_MAPS_API_KEY=tu_api_key_aqui # macOS/Linux export GOOGLE_MAPS_API_KEY=tu_api_key_aqui

Opción B: Archivo .env (recomendado para desarrollo)

# Copiar archivo de ejemplo cp .env.example .env # Editar .env con tu API key real # GOOGLE_MAPS_API_KEY=tu_api_key_real_aqui

2. Configurar Claude Desktop

Ubicación del archivo de configuración:

Windows: %APPDATA%\\Claude\\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Contenido del archivo:

{ "mcpServers": { "google-maps": { "command": "mcp-google-maps-stdio", "env": { "GOOGLE_MAPS_API_KEY": "tu_api_key_aqui" } } } }

3. Reiniciar Claude Desktop

¡Listo! Ya puedes usar Google Maps desde Claude Desktop.

🛠️ Herramientas Disponibles

📍 Geocoding: Convertir direcciones a coordenadas
🔄 Reverse Geocoding: Convertir coordenadas a direcciones
🔍 Búsqueda de Lugares: Encontrar lugares cercanos
🗺️ Direcciones: Calcular rutas entre puntos
📏 Matriz de Distancias: Calcular distancias entre múltiples puntos
⛰️ Elevación: Obtener datos de elevación
📋 Detalles de Lugares: Información detallada de lugares

📋 Requisitos

Node.js: >= 18.0.0
Google Maps API Key: Obtener en Google Cloud Console
Claude Desktop: Instalado y configurado

🔧 Configuración Avanzada

Variables de Entorno

GOOGLE_MAPS_API_KEY: Tu API key de Google Maps (requerida)
MCP_SERVER_PORT: Puerto del servidor HTTP interno (opcional, default: 3000)

Instalación desde Fuente

git clone https://github.com/vicente-alvarado/mcp-google-map-stdio.git cd mcp-google-map-stdio npm install npm run install-global

🆚 Diferencias con el Proyecto Original

Característica	Original (HTTP)	stdio Edition
Transporte	HTTP/SSE	stdio (JSON-RPC)
Cliente	Cualquier cliente HTTP	Solo Claude Desktop
Instalación	Local	Global + Local
Dependencias	Múltiples	Mínimas
Uso	Servidor web	Comando directo

🐛 Solución de Problemas

Error: "GOOGLE_MAPS_API_KEY not set"

# Verificar que la variable esté configurada echo $GOOGLE_MAPS_API_KEY # macOS/Linux echo %GOOGLE_MAPS_API_KEY% # Windows

Error: "Command not found: mcp-google-maps-stdio"

# Reinstalar globalmente npm install -g @vicente-alvarado/mcp-google-map-stdio

Claude Desktop no detecta el servidor

Verificar la configuración en claude_desktop_config.json
Reiniciar Claude Desktop completamente
Verificar que el comando mcp-google-maps-stdio funciona en terminal

📚 Documentación Completa

Ver CONFIGURACION_CLAUDE.md para:

Guía paso a paso detallada
Ejemplos de configuración
Solución de problemas avanzada
FAQ completo

🤝 Contribuir

Fork el proyecto
Crear una rama para tu feature (git checkout -b feature/AmazingFeature)
Commit tus cambios (git commit -m 'Add some AmazingFeature')
Push a la rama (git push origin feature/AmazingFeature)
Abrir un Pull Request

📄 Licencia

Este proyecto está bajo la Licencia MIT. Ver LICENSE para más detalles.

🙏 Agradecimientos

Basado en mcp-google-map original
Adaptado para soporte stdio con Claude Desktop
Wrapper desarrollado para compatibilidad total

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

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.

Enables Claude Desktop to access Google Maps services including geocoding, place search, directions, distance calculations, and elevation data through stdio communication. Provides comprehensive location-based functionality with direct Google Maps API integration.

MCP Google Maps - stdio Edition