Google Places MCP Server

Google Places MCP 服务

此 MCP 服务与 Google Places API 集成，可搜索地点、获取详情并查找附近的地点。

设置

环境变量

需要设置以下环境变量：

• GOOGLE_MAPS_API_KEY：已启用 Places API 访问权限的 Google Maps API 密钥
• TRANSPORT_TYPE：要使用的传输方式（stdio 或 sse）
• PORT：（可选）SSE 传输的端口号（默认值：3000）

在根目录中创建包含以下变量的 .env 文件：

GOOGLE_MAPS_API_KEY=your_api_key_here
PORT=3000

开发

1. 安装依赖项：

npm install

2. 启动开发服务器：

npm run dev

传输选项

此服务支持两种传输方式：

1. SSE（服务器发送事件）：使用 HTTP 和服务器发送事件进行实时通信

使用 SSE 传输时，服务会提供两个端点：

• GET /sse：用于接收服务消息的 SSE 端点
• POST /messages：用于向服务发送消息的端点

工具

• places-text-search

  • 使用 Google Places API 文本搜索地点
  • 输入：
    • textQuery（字符串，必需）：用于搜索地点的文本查询
    • includedType（字符串，可选）：将结果限制为符合指定类型的地点
    • includePureServiceAreaBusinesses（布尔值，可选）：是否包含没有实体地址的商家
    • languageCode（字符串，可选）：结果的语言代码（例如，"en"）
    • locationBias（对象，可选）：优先返回此位置附近的结果
    • locationRestriction（对象，可选）：将结果限制在此位置范围内
    • pageSize（数字，可选）：每页结果数（1-20）
    • pageToken（字符串，可选）：下一页结果的令牌
    • priceLevels（数组，可选）：按价格等级筛选
    • rankPreference（字符串，可选）：按 "RELEVANCE" 或 "DISTANCE" 排序
    • regionCode（字符串，可选）：两字符国家/地区代码
    • strictTypeFiltering（布尔值，可选）：仅返回类型完全匹配的结果
    • evOptions（对象，可选）：电动汽车充电站筛选条件
    • minRating（数字，可选）：最低评分筛选条件（0-5）
    • openNow（布尔值，可选）：筛选当前营业的地点
    • fields（数组，可选）：要包含在响应中的特定字段
  • 返回匹配地点及其详情

• places-nearby-search（即将推出）

  • 查找特定位置附近的地点
  • 输入：
    • location（对象，必需）：纬度和经度坐标
    • radius（数字，可选）：搜索半径，单位为米
    • keyword（字符串，可选）：用于筛选结果的关键词
    • type（字符串，可选）：用于筛选结果的地点类型
    • rankBy（字符串，可选）：按 "prominence" 或 "distance" 排序
    • openNow（布尔值，可选）：筛选当前营业的地点
    • fields（数组，可选）：要包含在响应中的特定字段
  • 返回附近地点及其详情

• place-details（即将推出）

  • 获取特定地点的详细信息
  • 输入：
    • placeId（字符串，必需）：Google Place ID
    • fields（数组，可选）：要包含在响应中的特定字段
    • languageCode（字符串，可选）：结果的语言代码
  • 返回地点的完整详情

• place-photo（即将推出）

  • 获取地点的照片
  • 输入：
    • photoReference（字符串，必需）：Place Details 响应中的引用
    • maxWidth（数字，可选）：返回图像的最大宽度
    • maxHeight（数字，可选）：返回图像的最大高度
  • 返回照片数据或 URL