Сервер Google Карт MCP

Сервер MCP для API Google Карт.

Инструменты

1. maps_geocode

   • Преобразовать адрес в координаты

   • Ввод: address (строка)

   • Возвращает: местоположение, formatted_address, place_id

2. maps_reverse_geocode

   • Преобразовать координаты в адрес

   • Входные данные:

     • latitude (число)

     • longitude (число)

   • Возвращает: formatted_address, place_id, address_components

3. maps_search_places

   • Поиск мест с помощью текстового запроса

   • Входные данные:

     • query (строка)

     • location (необязательно): { широта: число, долгота: число}

     • radius (необязательно): число (метры, макс. 50000)

   • Возвращает: массив мест с названиями, адресами, местонахождениями.

4. maps_place_details

   • Получить подробную информацию о месте

   • Ввод: place_id (строка)

   • Возвращает: имя, адрес, контактная информация, рейтинги, отзывы, часы работы

5. maps_distance_matrix

   • Рассчитать расстояние и время между точками

   • Входные данные:

     • origins (строка[])

     • destinations (строка[])

     • mode (необязательно): «вождение» | «пешеходная прогулка» | «езда на велосипеде» | «транзит»

   • Возвраты: матрица расстояний и длительностей

6. maps_elevation

   • Получить данные о высоте для местоположений

   • Входные данные: locations (массив {широта, долгота})

   • Возвращает: данные о высоте для каждой точки

7. maps_directions

   • Получить маршрут между точками

   • Входные данные:

     • origin (строка)

     • destination (строка)

     • mode (необязательно): «вождение» | «пешеходная прогулка» | «езда на велосипеде» | «транзит»

   • Возвращение: детали маршрута с указанием шагов, расстояния, продолжительности.

Related MCP server: mapbox-mcp-server

Настраивать

API-ключ

Получите ключ API Google Карт, следуя инструкциям здесь .

Использование с Claude Desktop

Добавьте следующее в ваш claude_desktop_config.json :

Докер

{
  "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>"
      }
    }
  }
}

НПХ

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

Использование с VS Code

Для быстрой установки используйте одну из кнопок установки в один клик ниже...

Для ручной установки добавьте следующий блок JSON в файл настроек пользователя (JSON) в VS Code. Это можно сделать, нажав Ctrl + Shift + P и введя Preferences: Open User Settings (JSON) .

При желании вы можете добавить его в файл .vscode/mcp.json в вашем рабочем пространстве. Это позволит вам поделиться конфигурацией с другими.

Обратите внимание, что ключ mcp не нужен в файле .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}"
        }
      }
    }
  }
}

Для установки 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}"
        }
      }
    }
  }
}

Строить

Сборка Docker:

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

Лицензия

Этот сервер MCP лицензирован по лицензии MIT. Это означает, что вы можете свободно использовать, изменять и распространять программное обеспечение в соответствии с условиями лицензии MIT. Для получения более подробной информации см. файл LICENSE в репозитории проекта.