Googleplaces MCP Server

谷歌放置MCP服务器

用于Google Places API集成的基于WebSocket的模型上下文协议服务器。使用JSON-RPC 2.0通信协议提供位置搜索、地点详细信息、天气数据和海拔信息。

特性

• 搜索地点：使用带有位置偏见的自然语言查询查找地点
• 获取地点详细信息：使用Google Place ID检索综合信息
• 获得天气：使用Google weather API（Google地图平台的一部分）的当前天气状况
• 获取海拔高度：使用Google Elevation API的位置的高程数据
• 单个API密钥：所有功能都使用相同的Google API密钥

快速开始

看 设置.md 有关详细的安装和配置说明。

# 1. Get your API key from Google Cloud Console
# 2. Set environment variable
export GOOGLE_PLACES_API_KEY="your_api_key"

# 3. Start the server
googleplaces-mcp-server

服务器运行在 http://localhost:3000 默认情况下。

可用工具

1.搜索位置

搜索地点并获取谷歌地点ID。

参数：

• query （必填）：搜索查询（例如，“我附近的星巴克”、“意大利餐厅”）
• location （可选）： {lat: number, lng: number} -位置偏差
• radius （可选）：搜索半径，单位为米（默认值：5000，最大值：50000）

退货：

• 地点列表 place_id、姓名、地址、坐标、等级

例子：

{
  "query": "coffee shops in Seattle",
  "location": {"lat": 47.6062, "lng": -122.3321},
  "radius": 2000
}

2.获取位置细节

使用Google place ID获取有关地点的完整详细信息。

参数：

• place_id （必填）：搜索结果中的Google Place ID

退货：

• 完整的地点信息，包括电话、网站、时间、评级

3.吃东西

使用Google weather API获取当前天气状况。

参数：

• location （必填）： {lat: number, lng: number} -位置坐标
• units （可选）：“公制”（摄氏度/公里），“英制”（华氏度/英里）。默认值：公制

退货：

• 当前天气：温度、感觉、露点、热指数、风寒
• 湿度、紫外线指数、降水量（概率、类型、数量）
• 雷暴概率、气压
• 风：方向（度和基数）、速度、阵风
• 能见度、云量
• 24小时历史：温度变化、最低/最高温度、降水量

例子：

{
  "location": {"lat": 47.6062, "lng": -122.3321},
  "units": "imperial"
}

注： 使用与位置和高程API相同的Google API键。

4.获取提升值

获取一个或多个位置的高程数据。

参数：

• locations （必填）：数组 {lat: number, lng: number} 坐标

退货：

• 每个位置的海拔高度（米）
• 高程数据的分辨率（精度）

例子：

{
  "locations": [
    {"lat": 47.6062, "lng": -122.3321},
    {"lat": 47.6205, "lng": -122.3493}
  ]
}

示例用例

将位置链接到您的应用程序数据：

1. 搜索：用户提到一个位置（例如，“第五大道上的星巴克”）
2. 获取建议：呼叫 search_places 与查询
3. 用户选择：显示结果，用户选择正确的位置
4. 商店：保存 place_id 在您的数据库中
5. 检索：使用 get_place_details 随时获取最新信息

这 place_id 提供对真实世界位置的持久引用，即使该位置更改名称或略有移动，该引用也保持有效。

发展

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

# Test
npm test

许可证

麻省理工学院