谷歌地图放置mcp
用于谷歌地图地点API的MCP服务器-搜索地点并获取照片。
用例
会议协调:有人发邮件说:“我们在办公室附近的Nando's见面吧——什么时间最适合你?”→ 你的人工智能助手会查找位置,检查开放时间,并将其与地址一起添加到你的日历中。
当地建议:询问“在国王十字车站附近找一家有WiFi的安静咖啡馆,进行2小时的工作”→ 获取带有评级、时间和照片的地点,以帮助您做出决定。
地址验证:在发送邮件或预订送货之前,确认或自动填写部分地址。
(这些只是示例-任何需要地点搜索或业务信息的工作流都可以使用此功能。)
设置
1.创建Google OAuth凭据
- 首选 谷歌云控制台
- 创建新项目(或使用现有项目)
- 启用 地点API(新增)
- 首选 API和服务 → OAuth 同意屏幕,设置同意屏幕
- 首选 API和服务 → 凭证 → 创建凭证 → OAuth客户端ID
- 选择 Web应用程序
- 添加
http://localhost:3000/callback到 授权重定向URI - 记下您的客户端ID和客户端密码
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客户端
claude mcp add --transport http google-maps-places-mcp http://localhost:3000/mcp建筑
此服务器充当 OAuth代理 谷歌:
graph LR
A[MCP client] B[google-maps-places-mcp] C[Google OAuth/API]- 服务器通过以下方式将自己宣传为OAuth授权服务器
/.well-known/oauth-authorization-server /register返回Google OAuth客户端凭据/authorize重定向到Google,将客户端的回调URL编码为状态/callback从Google接收代码并转发给客户端的回调/token向Google代理令牌请求,注入客户端凭据/mcp处理MCP请求,使用承载令牌调用Places API
服务器不持有令牌或状态,它只是将OAuth代理给谷歌。
工具
| 工具 | 说明 |
|---|---|
places_text_search | 通过文本查询搜索地点(例如,“我附近的咖啡店”) |
places_photo_get | 获取某个地点的照片URL |
OAuth作用域
cloud-platform-访问Google Cloud API(Places API New必需)
贡献
GitHub上欢迎拉取请求!开始:
- 安装Git和Node.js
- 克隆存储库
- 安装依赖项
npm install - 跑
npm run test运行测试 - 构建于
npm run build
发布
版本遵循 语义版本规范.
要发布:
- 使用
npm version升级版本 - 跑
git push --follow-tags使用标签推送 - 等待GitHub Actions发布到NPM注册表。
