← 返回目录

Google Maps MCP Server

社区

为AI代理提供18个Google Maps工具，涵盖地理编码、路线、搜索等。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他
Stars: ★ 473 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 25 天前
工具数: 18

56FMRS · C

该服务器功能丰富，提供了18个Google Maps工具，覆盖广泛的地理空间需求。支持多种传输和CLI模式，具有清晰的文档和项目结构。注意需要有效的API密钥和API启用。非官方项目，社区维护。

最强项 · 安装易用性 13/20 最弱项 · 可靠性 6/20

可靠性

6/20

安全与权限

12/20

维护活跃度

12/20

文档质量

13/20

安装易用性

13/20

查看各项评分依据

可靠性 6/20: 现有资料仅为 README 与 manifest，无源码、CI 工作流或已提交测试可供验证；happy path 看起来可行但无法确认 18 个工具与真实行为一致。另外 README 与 manifest 对默认传输方式描述不一致（stdio vs Streamable HTTP），错误处理和边界情况无证据，因此保守给分。
安全与权限 12/20: 未发现恶意代码、窃取密钥或破坏性操作迹象；工具均标注只读且无破坏性副作用，API 密钥通过环境变量/CLI/请求头提供并在 manifest 中标记为 secret。但对“服务端处理、按会话隔离、Zod 校验”等声明没有源码可查证，数据流向和第三方 API 传输内容披露也不完整；没有确认环节（因只读可接受）。因此不触红线但无法给满分。
维护活跃度 12/20: 仓库未归档、有 MIT 许可证、版本号 0.0.53、README 含变更日志、路线图、贡献指南和安全响应说明，所有权与联系信息明确。但缺少提交/发布时间、问题响应和依赖更新记录等可验证证据，星标仅作发现信号不计分，因此给 12。
文档质量 13/20: README 覆盖安装、认证（API key 三种方式）、工具列表、stdio/HTTP/exec 示例和部分限制（批量 50 条、25 站点、并发 20 等），并提到分层文档（技能、项目文档、安全评估）。但缺少明确的故障排查、费用说明和完整参数文档内容，且这些分层文档本身未提供可核验内容。
安装易用性 13/20: 使用 npx 一键启动、环境变量密钥和成熟客户端（Claude Desktop/Cursor）的 JSON 配置示例，步骤清晰且跨平台（Node.js）。但由于没有 CI/测试执行证据，且存在传输方式默认值描述不一致、依赖外部 Google Cloud API 开通，按静态校准上限保守给 13。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要地理空间能力的AI代理
旅行规划应用
本地搜索和物流优化
本地SEO分析
需要地图可视化、路线优化的开发者

不适合谁

不需要Google Maps功能的简单聊天机器人
需要高精度定位、但不希望依赖外部API密钥的私有部署
需要实时交通流、街景、移动设备导航的用例（未提供）
需要Google官方支持的场景，因为这是社区项目

所需权限

需要有效的Google Maps API密钥（`GOOGLE_MAPS_API_KEY`），并启用Places API (New)和Routes API。
服务器会向Google Maps API发出外部网络请求。
所有工具标注为`readOnlyHint: true`，无需用户确认即可自动批准。
如果需要，可以通过环境变量过滤启用的工具。

风险与副作用

API密钥泄露风险：请妥善保管，不要提交到公共仓库。
费用风险：大量调用可能导致Google Cloud账户产生费用，建议设置配额和预算。
数据隐私：发送给API的地址和坐标可能被视为敏感信息。
工具可能被用于恶意目的（如跟踪），但本身是只读的。

安装接入

准备工作

运行环境：Node.js

GOOGLE_MAPS_API_KEY 必填密钥 Google Maps API 密钥（必需），在 https://console.cloud.google.com 创建；使用地点和路线相关工具前需启用 Places API (New) 和 Routes API。

其他可选配置项（1 个）

GOOGLE_MAPS_ENABLED_TOOLS 可选可选，逗号分隔的工具名单，用于只注册部分工具以减少上下文占用；省略或设为 * 表示启用全部 18 个工具。

在Google Cloud Console中启用Places API (New)和Routes API。
获取Google Maps API密钥。
在MCP客户端配置中，使用npx运行：npx -y @cablate/mcp-google-map --stdio，并设置环境变量GOOGLE_MAPS_API_KEY。
可选：设置GOOGLE_MAPS_ENABLED_TOOLS以限制启用的工具。
也可通过--port和--host启动HTTP服务器。

claude_desktop_config.json

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

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add google-maps -e GOOGLE_MAPS_API_KEY=YOUR_API_KEY -- npx -y @cablate/mcp-google-map --stdio

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中应出现 maps_geocode、maps_directions 等工具；发送“把东京塔的地址转成坐标”，能返回经纬度即说明连接成功。注意需先在 Google Cloud Console 启用 Places API (New) 和 Routes API。

常见排障

如果工具调用失败，请检查API密钥是否有效，以及Places API (New)和Routes API是否已启用。
确认MCP客户端配置正确，环境变量已设置。
如果使用HTTP模式，检查端口是否被占用，以及主机绑定是否正确。
查看服务器日志以获取详细错误信息。
如果只启用部分工具，确认`GOOGLE_MAPS_ENABLED_TOOLS`语法正确。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

把东京塔的地址转成GPS坐标
帮我找神户附近评分4分以上的咖啡店
规划一条从大阪到京都、途经奈良的多站路线并优化停靠顺序
东京今天的天气和空气质量怎么样？

工具能力 18

maps_search_nearby 只读

按类型（餐厅、咖啡馆、酒店等）查找地点附近的地方，支持按半径、评分和营业状态过滤。

maps_search_places 只读

自由文本地点搜索（如“东京的寿司餐厅”），支持位置偏差、评分和营业中过滤。

maps_place_details 只读

通过place_id获取地点的完整详情——评论、电话、网站、营业时间，可选maxPhotos参数返回照片URL。

maps_geocode 只读

将地址或地标名称转换为GPS坐标。

maps_reverse_geocode 只读

将GPS坐标转换为街道地址。

maps_distance_matrix 只读

计算多个起点和终点之间的旅行距离和时间，驾驶模式支持避开收费站和高速公路。

maps_directions 只读

获取两点之间的逐步导航和路线详情，驾驶模式支持避开收费站和高速公路。

maps_elevation 只读

获取地理坐标的海拔高度（米）。

展开其余 10 个工具

maps_timezone 只读

获取坐标的时区ID、名称、UTC/DST偏移和当地时间。

maps_weather 只读

获取当前天气状况或预报——温度、湿度、风速、紫外线、降水量。

maps_air_quality 只读

获取空气质量指数、污染物浓度和按人群划分的健康建议。

maps_static_map 只读

生成带标记、路径或路线的地图图像，以内联方式返回供用户直接查看。

maps_batch_geocode 只读

一次调用对最多50个地址进行地理编码，返回每个地址的坐标。

maps_search_along_route 只读

搜索两点之间路线沿途的地点，按最小绕行时间排序。

maps_explore_area 只读

探索一个位置周围的情况——一次调用搜索多种地点类型并获取详情。

maps_plan_route 只读

规划优化的多站路线，使用Routes API的航点优化（最多25站）进行高效排序，驾驶模式支持避开收费站和高速公路。

maps_compare_places 只读

并排比较地点——搜索、获取详情，并可选择计算距离。

maps_local_rank_tracker 只读

跟踪企业在地理网格上的本地搜索排名，支持最多3个关键词批量扫描，返回每个点的排名、前三名竞争对手和指标（ARP、ATRP、SoLV）。

使用场景

旅行规划：地理编码→搜索→路线→天气。

房地产分析：搜索附近设施、海拔、通勤时间。

物流优化：高效规划多站配送路线。

现场销售：访问客户并查找午餐地点。

灾害响应：查找最近的开放医院、洪水风险。

内容创作：分析社区特性。

无障碍：查找无障碍餐厅、避开陡峭路线。

本地SEO：分析本地排名和竞争对手。

支持客户端

Claude Desktop

Cursor

VS Code

依据项目文档列出，未经本站实测。

详细介绍

这是一个基于Model Context Protocol (MCP)的服务器，整合了Google Maps API和LLM处理能力，为AI代理提供全面的地理空间工具。它包含18个工具（14个原子工具和4个复合工具），支持地理编码、地点搜索、路线规划、天气、空气质量等功能。支持多种传输方式（stdio、Streamable HTTP）和独立的CLI执行模式。内置Agent Skill定义，指导AI如何链式使用地理工具。