地图mcp
A. 模型上下文协议 谷歌地图服务器——路线、地点发现和通勤比较 标准.
工具
get_transit_commute
两个地址（或社区）之间的路线。支持 transit （默认）， driving, walking, bicycling, two_wheeler多程旅行 intermediates (A→B→C).最多返回3条备选路线，每条路线都有：
mode,duration_minutes,distance_km,summary,steps_count- 过境：
segments（线路+车辆类型），transfers,walking_minutes,first_departure,last_arrival - 驾驶/两轮车：
duration_in_traffic_minutes（交通感知），toll_roads
search_places
使用免费文本查询查找餐馆、酒店、景点、公园、加油站等。可选择按位置偏置(near)，按地点类型过滤(type)，并筛选到当前打开的位置(open_now).返回最多20个结果，包括名称、地址、评级、价格水平、打开/关闭状态和 id 以便后续跟进。
get_place_details
地点的详细信息 search_places：电话、网站、每日开放时间、编辑摘要和最多5条用户评论。需要一个 place_id.
compare_commutes
根据旅行时间，将2-5个候选出发地与共享目的地进行排名。并行扇出并返回排序最快的结果→ 最慢的。每个原点的失败都是内联的，而不是中止整个比较。
谷歌云设置
在 谷歌云控制台，选择或创建项目并启用这些API(API和服务→ 图书馆):
- 路线API --for
get_transit_commute和compare_commutes - 地点API（新增） --for
search_places和get_place_details
然后 凭证→ 创建凭据→ API密钥。将密钥限制为这两个API。输入值 .env:
echo 'GOOGLE_MAPS_API_KEY=your-key-here' > .env设置和运行
npm install
npm run build
npm start # or: npx tsx src/index.ts (dev, no build needed)| 设定目标 | 它的作用 |
|---|---|
make install | npm ci |
make build | 编译TypeScript→ dist/ |
make dev / make start | 运行服务器（开发/编译） |
make test | 单元+内存e2e测试 |
make test-live | API实时测试（需要密钥） |
make smoke | 一个真正的API请求 |
make docker-build / make docker-run | 构建/运行Docker镜像 |
连接客户端（例如Cursor/Claude Desktop）
{
"mcpServers": {
"maps-mcp": {
"command": "node",
"args": ["/absolute/path/to/maps-mcp/dist/index.js"],
"env": { "GOOGLE_MAPS_API_KEY": "your-key-here" }
}
}
}对于没有构建的开发人员： "command": "npx", "args": ["tsx", "/absolute/path/to/maps-mcp/src/index.ts"].
备注
- MCP服务器名称：
google-maps-transit driving和two_wheeler使用TRAFFIC_AWARE路由（路由API v2）- 多达
MAX_ROUTES = 3备选方案返回；谷歌可能会减少回报 - 缺失
GOOGLE_MAPS_API_KEY表面作为明显的刀具误差