AI导哈

地点服务协议服务器

基于WebSocket的Google Places API集成服务，提供地点搜索、详情查询、天气数据和海拔信息。

  • by svarun115
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 svarun115/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

许可证

麻省理工学院

相关 MCP