F
license-
qualityC
maintenanceEnables location-aware AI agents to search for nearby places, get detailed place information including hours and ratings, and calculate routes with turn-by-turn directions using Google Maps APIs.
21
Google Maps MCP Server
🗺️ Google Maps MCP サーバー (gmaps-mcp)
公式の MCP Python SDK を使用して構築された、自己完結型で軽量な Google Maps Model Context Protocol (MCP) サーバーです。AI エージェント（Claude Desktop、Cursor、Cline、Antigravity など）に、構造化された検索結果、場所の詳細、評価、連絡先情報、座標、Google Maps URL を提供します。
⚡ 主な機能
ワンコマンドインストール: 手動で環境を設定することなく、
uvxを使用してどこでも即座に実行できます。100% 自己完結型: スクレイパーエンジンは、
asyncioとaiohttpを介してプロセス内でネイティブに統合されています。外部サブプロセス、ヘッドレスブラウザ、API キーは必要ありません。豊富な構造化された場所データ: プレイス ID、ビジネス名、カテゴリ、住所、ローカルおよび国際電話番号、ウェブサイト URL、座標（
lat/long）、星評価、レビュー数、Google Maps への直接リンクを返します。Stdio および Streamable HTTP: デスクトップ AI クライアント向けのネイティブ
stdioサポートと、リモート/コンテナ化されたデプロイメント向けの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（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json、Windows の場合は %APPDATA%\Claude\claude_desktop_config.json）に追加します:
{
"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 でビジネス、観光スポット、サービス、ランドマークを検索します。
パラメータ | タイプ | デフォルト | 説明 |
|
| (必須) | 検索語句（例: |
|
|
| 返す結果の最大数（ |
|
|
| 地域ローカライゼーション用の 2 文字の ISO 国コード（例: |
|
|
| 結果の言語コード（例: |
出力構造
{
"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
プレイス ID または名前で、特定の場所やビジネスの詳細情報を取得します。
パラメータ | タイプ | デフォルト | 説明 |
|
| (必須) | Google プレイス ID（例: |
|
|
| 2 文字の ISO 国コード（デフォルト: |
|
|
| 応答の言語コード（デフォルト: |
🌐 リモートデプロイメント（Streamable HTTP）
このサーバーは、リバースプロキシやクラウドホスティングの背後にデプロイするための最新の Streamable HTTP トランスポートをサポートしています:
# Start Streamable HTTP server on port 8000
uv run gmaps-mcp --transport streamable-http --host 0.0.0.0 --port 8000MCP エンドポイントは以下で利用可能になります:
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 ライセンスの下で提供されています。
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.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI assistants to access Google Maps services including places search, details, directions, geocoding, and nearby search through natural language.62MIT
- Flicense-qualityCmaintenanceEnables AI assistants to search and scrape Google Maps places data (name, rating, address, etc.) directly without an API key.
- AlicenseAqualityBmaintenanceEnables AI assistants to scrape Google Maps business data (names, addresses, phones, emails, websites, ratings, etc.) through natural language queries, with tools for synchronous and asynchronous scraping and credit checking.4323MIT
Related MCP Connectors
Live Google Maps business search, review, and photo data for AI agents over MCP.
Local business intel for AI agents: audits, lead scoring, tech stack, prospecting.
The best web search for your AI Agent
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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