Servidor MCP de Google Maps

Servidor MCP para la API de Google Maps.

Herramientas

1. maps_geocode

   • Convertir dirección a coordenadas

   • Entrada: address (cadena)

   • Devuelve: ubicación, dirección formateada, id del lugar

2. maps_reverse_geocode

   • Convertir coordenadas en dirección

   • Entradas:

     • latitude (número)

     • longitude (número)

   • Devuelve: dirección formateada, id de lugar, componentes de dirección

3. maps_search_places

   • Buscar lugares mediante consultas de texto

   • Entradas:

     • query (cadena)

     • location (opcional): { latitud: número, longitud: número }

     • radius (opcional): número (metros, máximo 50000)

   • Devuelve: una matriz de lugares con nombres, direcciones y ubicaciones.

4. maps_place_details

   • Obtenga información detallada sobre un lugar

   • Entrada: place_id (cadena)

   • Devoluciones: nombre, dirección, información de contacto, valoraciones, reseñas, horario de apertura

5. maps_distance_matrix

   • Calcular distancias y tiempos entre puntos

   • Entradas:

     • origins (cadena[])

     • destinations (cadena[])

     • mode (opcional): "conducir" | "caminar" | "andar en bicicleta" | "transporte público"

   • Devoluciones: matriz de distancias y duraciones

6. maps_elevation

   • Obtener datos de elevación para ubicaciones

   • Entrada: locations (matriz de {latitud, longitud})

   • Devuelve: datos de elevación para cada punto

7. maps_directions

   • Obtener direcciones entre puntos

   • Entradas:

     • origin (cadena)

     • destination (cadena)

     • mode (opcional): "conducir" | "caminar" | "andar en bicicleta" | "transporte público"

   • Devuelve: detalles de la ruta con pasos, distancia y duración.

Related MCP server: mapbox-mcp-server

Configuración

Clave API

Obtenga una clave API de Google Maps siguiendo las instrucciones aquí .

Uso con Claude Desktop

Agregue lo siguiente a su claude_desktop_config.json :

Estibador

{
  "mcpServers": {
    "google-maps": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GOOGLE_MAPS_API_KEY",
        "mcp/google-maps"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "google-maps": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-google-maps"],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Uso con VS Code

Para una instalación rápida, utilice uno de los botones de instalación de un solo clic que aparecen a continuación...

Para la instalación manual, agregue el siguiente bloque JSON a su archivo de configuración de usuario (JSON) en VS Code. Para ello, presione Ctrl + Shift + P y escriba Preferences: Open User Settings (JSON) .

Opcionalmente, puede agregarlo a un archivo llamado .vscode/mcp.json en su espacio de trabajo. Esto le permitirá compartir la configuración con otros.

Tenga en cuenta que la clave mcp no es necesaria en el archivo .vscode/mcp.json .

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "maps_api_key",
        "description": "Google Maps API Key",
        "password": true
      }
    ],
    "servers": {
      "google-maps": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-google-maps"],
        "env": {
          "GOOGLE_MAPS_API_KEY": "${input:maps_api_key}"
        }
      }
    }
  }
}

Para la instalación de Docker:

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "maps_api_key",
        "description": "Google Maps API Key",
        "password": true
      }
    ],
    "servers": {
      "google-maps": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "mcp/google-maps"],
        "env": {
          "GOOGLE_MAPS_API_KEY": "${input:maps_api_key}"
        }
      }
    }
  }
}

Construir

Compilación de Docker:

docker build -t mcp/google-maps -f src/google-maps/Dockerfile .

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.