Google Maps Places

google-maps-places-mcp

用于 Google Maps Places API 的 MCP 服务——搜索地点并获取照片。

使用场景

会议协调：有人发邮件说“我们在办公室附近的 Nando's 碰面吧——你觉得几点合适？”→ 你的 AI 助手会查找地点、查看营业时间，并将地址添加到日历中。

本地推荐：询问“帮我找一家 King's Cross 附近有 WiFi、适合工作 2 小时的安静咖啡馆”→ 获取地点的评分、营业时间和照片，助你做出决定。

地址验证：在寄送邮件或预订配送之前，确认或自动补全不完整的地址。

（这些只是示例——任何需要搜索地点或获取商家信息的工作流都可以使用此工具。）

设置

1. 创建 Google OAuth 凭据

1. 前往 Google Cloud Console
2. 创建新项目（或使用现有项目）
3. 启用 Places API (New)
4. 前往 APIs & Services → OAuth consent screen，设置同意屏幕
5. 前往 APIs & Services → Credentials → Create Credentials → OAuth client ID
6. 选择 Web application
7. 将 http://localhost:3000/callback 添加到 Authorized redirect URIs
8. 记下 Client ID 和 Client Secret

2. 运行服务

GOOGLE_CLIENT_ID='your-client-id' \
GOOGLE_CLIENT_SECRET='your-client-secret' \
MCP_TRANSPORT=http \
npm start

服务默认运行在 http://localhost:3000。使用 PORT=3001 更改端口。

3. 添加到 MCP 客户端

启动服务后，按照 install-mcp 上的说明操作。它会为你的 MCP 客户端（Claude Code、Claude Desktop、Cursor、Cline、VS Code 等）生成相应的配置。

架构

此服务充当连接 Google 的 OAuth 代理：

graph LR
    A[MCP client] <--> B[google-maps-places-mcp] <--> C[Google OAuth/API]

1. 服务通过 /.well-known/oauth-authorization-server 将自身声明为 OAuth 授权服务
2. /register 返回 Google OAuth 客户端凭据
3. /authorize 重定向到 Google，并在 state 中编码客户端的回调 URL
4. /callback 接收来自 Google 的授权码，并转发到客户端的回调地址
5. /token 将令牌请求代理到 Google，并注入客户端凭据
6. /mcp 处理 MCP 请求，使用 bearer token 调用 Places API

服务不保存令牌或状态——它只代理发往 Google 的 OAuth 请求。

工具

工具	描述
places_text_search	按文本查询搜索地点（例如，“附近的咖啡店”）
places_photo_get	获取某个地点的照片 URL

OAuth 权限范围

• cloud-platform - 访问 Google Cloud API（Places API New 所必需）

参与贡献

欢迎在 GitHub 上提交 Pull Request！开始贡献：

1. 安装 Git 和 Node.js
2. 克隆仓库
3. 使用 npm install 安装依赖项
4. 运行 npm run test 执行测试
5. 使用 npm run build 构建

发布

版本遵循语义化版本规范。

发布步骤：

1. 使用 npm version <major | minor | patch> 更新版本号
2. 运行 git push --follow-tags 推送并附带标签
3. 等待 GitHub Actions 发布到 NPM 注册表。