CM

cablate/mcp-google-map

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

487 stars 94 forks 品質 88 トレンド 36MIT

強力なモデルコンテキストプロトコル(MCP)サーバーで、包括的なGoogle Maps APIとLLM処理機能の統合を提供します。

概要

AIエージェントに物理的な世界を理解する能力を与えましょう。ジオコード、ルート、検索、位置の推論などです。 - — 14 atomic + 4 composite(explore-area、plan-route、compare-places、local-rank-tracker) - — stdio、StreamableHTTP、スタンドアロンのexec CLI - — 組み込みのスキル定義でAIにジオツールの連鎖(スキル/Googleマップなど)を教えます streamablehttpのサポート追加にご協力いただいたご@junyinnnnに特別な感謝を申し上げます。 すべてのツールにはreadOnlyHint: trueおよびdestructiveHint: falseで注釈が付けられています — MCPクライアントはユーザーの確認なしにこれらを自動承認できます。 : 場所関連やルーティングツールを使用する前に、Google Cloud Consoleでを有効にしてください。 Claude Desktop、カーソル、VS Code、およびstdioをサポートする任意のMCPクライアントで動作します: — 工具の一部だけが必要な場合は、GOOGLE_MAPS_ENABLED_TOOLSを登録する工具を制限します。 18種類のツールすべてで省略または*に設定してください(デフォルト)。

概要(AI 翻訳)

すべてのAIアプリで場所検索、ルーティング、位置情報のワークフローを再構築するのはやめましょう。

@cablate/mcp-google-mapはGoogleマッププラットフォームを18の読み取り専用エージェントツールと3つの専門スキルに変換します。エージェントは実際の場所を見つけ、ルートを確認し、選択肢を比較し、実用的な旅程を作成し、ローカル検索の可視性を監査できます。これらはMCPやスタンドアロンのCLIを通じて可能です。

統合モデルは、MCP設定なしのスキルを使いたい場合はCodexかClaude Code Plugin、デスクトップMCPクライアントにはStdio、共有やリモート展開にはStreamable HTTPを選びます。

英語 ·繁體中文

なぜ使うのか?

エージェントに生のMaps APIを与えることは始まりに過ぎません。有用な回答を得るには、複数の依存コールが必要です:場所の解決、そのアイデンティティの保持、周囲の検索、開店の詳細確認、移動時間の計算、そして実際に検証されたものの説明。このプロジェクトはそれらを一つの一貫したインターフェースにまとめています。

  • 検索から結果への移行 原子ツールはジオコーディング、場所の詳細、方向、天候、大気質、地図を扱います。複合ツールはエリア探索、候補者比較、停車点の最適化、地域ランキングの測定を行います。
  • **MCPの有無にかかわらず同じ機能を使用してください。

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Google Maps for AI agents

Stop rebuilding place search, routing, and location workflows for every AI app.

@cablate/mcp-google-map turns Google Maps Platform into 18 read-only agent tools and three focused Skills. An agent can find real places, verify routes, compare options, build practical itineraries, or audit local search visibility—through MCP or a standalone CLI.

You choose the integration model: Codex or Claude Code Plugin when you want Skills without MCP setup, stdio for desktop MCP clients, or Streamable HTTP for shared and remote deployments.

English · 繁體中文

Why use it?

Giving an agent a raw Maps API is only the beginning. Useful answers often require several dependent calls: resolve a place, preserve its identity, search around it, check opening details, calculate travel time, and explain what was actually verified. This project packages that work into one consistent interface.

  • Move from lookup to outcome. Atomic tools handle geocoding, place details, directions, weather, air quality, and maps. Composite tools explore areas, compare candidates, optimize stops, and measure local rankings.
  • Use the same capabilities with or without MCP. The standalone exec CLI works with Agent Skills and automation; the MCP server exposes the same 18 tools over stdio or HTTP.
  • Give agents workflow guidance, not just function names. Three Skills cover general map research, evidence-backed travel planning, and local SEO. Codex loads their full instructions only when a request matches.
  • Keep deployment and credentials under your control. Run locally or self-host. API keys remain in your environment or request headers, with per-session isolation for HTTP deployments.
  • Start narrow and grow later. Register only the tools you need with GOOGLE_MAPS_ENABLED_TOOLS, or use the full catalog.

What can an agent do?

Outcome How the project helps
GitHub で README 全文を見る

インストール

npx -y @cablate/mcp-google-map --stdio
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "google-maps": { "command": "npx", "args": ["-y", "@cablate/mcp-google-map", "--stdio"], "env": { "GOOGLE_MAPS_API_KEY": "YOUR_API_KEY" } } } }