一台强大的模型上下文协议（MCP）服务器，提供全面的谷歌地图API集成与大型语言模型处理能力。
概览
赋予你的人工智能代理理解物理世界的能力——地理编码、路线、搜索以及对位置的推理。 - — 14 原子 + 4 复合（探索区域、规划路线、比较地点、本地排名追踪器）—— stdio、StreamableHTTP、独立执行CLI —— 内置技能定义教 AI 如何串接地理工具（技能/谷歌地图/） 特别感谢@junyinnnn帮助支持streamablehttp。 所有工具均标注 readOnlyHint：true 和 destructiveHint：false ——MCP 客户端可在无需用户确认的情况下自动批准这些。 ：在使用与地点相关的和路由工具之前，请在Google Cloud Console中启用并操作。 可兼容 Claude Desktop、Cursor、VS Code 以及任何支持 stdio 的 MCP 客户端： ——如果你只需要部分工具，可以设置GOOGLE_MAPS_ENABLED_TOOLS限制注册工具： 省略或设置为*，适用于所有18个工具（默认）。
概述（AI 翻译）
停止为每个AI应用重建地点搜索、路由和位置工作流程。
@cablate/mcp-google-map 将谷歌地图平台转化为18个只读代理工具和三项专注技能。代理可以通过MCP或独立的CLI查找真实地点、核实路线、比较选项、制定实用行程，或审计本地搜索可见度。
你可以选择集成模式：想要技能无MCP设置时用Codex或Claude Code插件，桌面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
execCLI 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 |
|---|
安装
npx -y @cablate/mcp-google-map --stdio配置
{
"mcpServers": {
"google-maps": {
"command": "npx",
"args": ["-y", "@cablate/mcp-google-map", "--stdio"],
"env": { "GOOGLE_MAPS_API_KEY": "YOUR_API_KEY" }
}
}
}