Skip to main content
Glama
deenesjakoruzh
devsanthoshmk

Google Maps MCP Server

by devsanthoshmk
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

🗺️ Google Maps MCP сервер (gmaps-mcp)

MCP Version Python License: MIT

Самодостаточный, легковесный Google Maps Model Context Protocol (MCP) сервер, построенный на официальном MCP Python SDK. Он предоставляет AI-агентам (таким как Claude Desktop, Cursor, Cline и Antigravity) структурированные результаты поиска, информацию о местах, рейтинги, контактные данные, координаты и ссылки на Google Maps.

⚡ Ключевые возможности

  • Установка одной командой: Запускается мгновенно из любого места через uvx без ручной настройки окружения.

  • 100% автономность: Движок парсинга встроен нативно в процесс через asyncio и aiohttp — не требуется внешних подпроцессов, безголовых браузеров или ключей API.

  • Богатые структурированные данные о местах: Возвращает идентификаторы мест, названия бизнесов, категории, адреса, местные и международные номера телефонов, URL-адреса веб-сайтов, координаты (lat/long), звездные рейтинги, количество отзывов и прямые ссылки на Google Maps.

  • Stdio и Streamable HTTP: Встроенная поддержка stdio для десктопных AI-клиентов и streamable-http для удаленных/контейнеризированных развертываний.

  • Чистый JSON-RPC: Все внутреннее логирование строго направляется в stderr, поддерживая поток протокола stdio на 100% совместимым.

Related MCP server: Google Maps MCP Server

🚀 Быстрый старт

Запуск напрямую с помощью uvx:

# Run directly from GitHub repository
uvx --from git+https://github.com/<your-username>/gmaps-mcp.git gmaps-mcp

Или из локального клона:

uv run gmaps-mcp

🛠️ Настройка MCP-клиента

1. Claude Desktop

Добавьте это в ваш claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json на macOS, или %APPDATA%\Claude\claude_desktop_config.json на Windows):

{
  "mcpServers": {
    "google-maps": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/<your-username>/gmaps-mcp.git",
        "gmaps-mcp"
      ]
    }
  }
}

Если запуск из локальной папки:

{
  "mcpServers": {
    "google-maps": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/gmap-mcp",
        "gmaps-mcp"
      ]
    }
  }
}

2. Cursor IDE

В Cursor откройте Settings → Features → MCP (или отредактируйте .cursor/mcp.json в вашем проекте):

{
  "mcpServers": {
    "google-maps": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/<your-username>/gmaps-mcp.git",
        "gmaps-mcp"
      ]
    }
  }
}

3. Cline (расширение VS Code)

В настройках Cline (cline_mcp_settings.json):

{
  "mcpServers": {
    "google-maps": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/<your-username>/gmaps-mcp.git",
        "gmaps-mcp"
      ]
    }
  }
}

🧰 Доступные инструменты

1. search_google_maps

Поиск по Google Maps для бизнесов, достопримечательностей, услуг и ориентиров.

Параметр

Тип

По умолчанию

Описание

query

string

(обязательно)

Поисковый запрос (например, "coffee in Koramangala Bangalore", "dentists near Connaught Place Delhi", "Italian restaurants in New York").

limit

integer

10

Максимальное количество результатов для возврата (от 1 до 50).

country

string

"in"

Двухбуквенный код страны ISO для локализации региона (например, "in", "us", "gb", "de", "fr", "ae").

language

string

"en"

Код языка для результатов (например, "en", "hi", "es", "fr").

Структура вывода

{
  "query": "coffee in Koramangala Bangalore",
  "country": "in",
  "language": "en",
  "total_results": 2,
  "places": [
    {
      "place_id": "ChIJ80IECk8UrjsRqCffDjE09lw",
      "name": "Dyu Art Cafe",
      "category": "Art cafe",
      "address": "KHB MIG Colony, 1st Cross Rd, Koramangala 8th Block, Bengaluru, Karnataka 560095",
      "phone": "096113 19774",
      "international_phone": "+91 96113 19774",
      "website": "http://www.dyuartcafe.com/",
      "domain": "dyuartcafe.com",
      "latitude": 12.9373076,
      "longitude": 77.6176544,
      "rating": 4.4,
      "review_count": 21440,
      "google_maps_url": "https://www.google.com/maps/place/?q=place_id:ChIJ80IECk8UrjsRqCffDjE09lw"
    }
  ]
}

2. get_place_details

Получение подробной информации об одном конкретном месте или бизнесе по его идентификатору места или названию.

Параметр

Тип

По умолчанию

Описание

place

string

(обязательно)

Google Place ID (например, "ChIJ12k5kG_iDDkRwuzibQwYZ4M") или точное название бизнеса/достопримечательности (например, "AIIMS New Delhi").

country

string

"in"

Двухбуквенный код страны ISO (по умолчанию: "in").

language

string

"en"

Код языка для ответа (по умолчанию: "en").

🌐 Удаленное развертывание (Streamable HTTP)

Сервер поддерживает современный транспорт Streamable HTTP для развертывания за обратными прокси или в облачных хостингах:

# Start Streamable HTTP server on port 8000
uv run gmaps-mcp --transport streamable-http --host 0.0.0.0 --port 8000

MCP-эндпоинт будет доступен по адресу: http://<host>:8000/mcp

🧪 Разработка и тестирование

Запуск модульных и интеграционных тестов с помощью uv:

# Run pytest test suite
uv run --with pytest --with pytest-asyncio pytest tests/ -v

# Run the server locally with debug logs
uv run gmaps-mcp --log-level DEBUG

📦 Структура проекта

gmap-mcp/
├── pyproject.toml              # Packaging & dependencies (PEP 517/621)
├── README.md                   # Setup guide and MCP client docs
├── src/
│   └── gmaps_mcp/
│       ├── __init__.py         # Package entry
│       ├── schemas.py          # Pydantic data models (Place, Search, Details)
│       ├── server.py           # MCPServer instance & CLI runner
│       ├── tools.py            # MCP Tool definitions & detailed descriptions
│       └── scraper/
│           ├── __init__.py     # Scraper API
│           └── crawler.py      # Async Google Maps parser & extraction engine
└── tests/
    ├── test_schemas.py         # Schema tests
    ├── test_crawler.py         # Parser unit tests
    └── test_server.py          # MCP Server registration & tool calling tests

📜 Атрибуция и лицензия

  • Ядро парсера адаптировано и модуляризировано из christivn/mapScraper (коммит 1b38cf3e153294e3dad2f6cb5862be0201a54065).

  • Лицензировано под MIT License.

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Google Maps Scraper

    Live Google Maps business search, review, and photo data for AI agents over MCP.

  • bizintel

    Local business intel for AI agents: audits, lead scoring, tech stack, prospecting.

  • Parallel Search MCP

    The best web search for your AI Agent

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/devsanthoshmk/gmaps-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server