适合谁
- 需要地理空间能力的AI代理
- 旅行规划应用
- 本地搜索和物流优化
- 本地SEO分析
- 需要地图可视化、路线优化的开发者
G
56FMRS · C
该服务器功能丰富，提供了18个Google Maps工具，覆盖广泛的地理空间需求。支持多种传输和CLI模式，具有清晰的文档和项目结构。注意需要有效的API密钥和API启用。非官方项目，社区维护。
这是一个基于Model Context Protocol (MCP)的服务器，整合了Google Maps API和LLM处理能力，为AI代理提供全面的地理空间工具。它包含18个工具（14个原子工具和4个复合工具），支持地理编码、地点搜索、路线规划、天气、空气质量等功能。支持多种传输方式（stdio、Streamable HTTP）和独立的CLI执行模式。内置Agent Skill定义，指导AI如何链式使用地理工具。
工具能力
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
获取地理坐标的海拔高度（米）。
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）。
安装接入
- 在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"
}
}
}
}
选型与风险
不适合谁
- 不需要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的地址和坐标可能被视为敏感信息。
- 工具可能被用于恶意目的（如跟踪），但本身是只读的。
常见排障
- 如果工具调用失败，请检查API密钥是否有效，以及Places API (New)和Routes API是否已启用。
- 确认MCP客户端配置正确，环境变量已设置。
- 如果使用HTTP模式，检查端口是否被占用，以及主机绑定是否正确。
- 查看服务器日志以获取详细错误信息。
- 如果只启用部分工具，确认`GOOGLE_MAPS_ENABLED_TOOLS`语法正确。
使用场景
旅行规划：地理编码→搜索→路线→天气。
房地产分析：搜索附近设施、海拔、通勤时间。
物流优化：高效规划多站配送路线。
现场销售：访问客户并查找午餐地点。
灾害响应：查找最近的开放医院、洪水风险。
内容创作：分析社区特性。
无障碍：查找无障碍餐厅、避开陡峭路线。
本地SEO：分析本地排名和竞争对手。
支持客户端
Claude Desktop完整支持
Cursor完整支持
VS Code完整支持