Google Places MCP Server

基本能力

产品定位

Google Places MCP Server 主要用于与 Google Places API 集成，提供地点搜索、详细信息检索和附近地点查找功能。

核心功能

1. 地点文本搜索：通过文本查询搜索地点，支持多种过滤条件（如语言、位置偏好、评分等）。
2. 附近地点搜索：根据地理位置查找附近的地点，支持半径、关键词、类型等过滤条件。
3. 地点详细信息：获取特定地点的详细信息，支持自定义字段和语言。
4. 地点自动完成：根据用户输入提供地点预测，支持会话令牌和位置偏好。
5. 地点照片检索：获取地点的照片，支持最大宽度和高度的设置。

适用场景

1. 地图应用中的地点搜索和详细信息展示。
2. 旅行或导航应用中的附近地点查找。
3. 需要地点自动完成功能的搜索框。
4. 需要展示地点照片的应用。

工具列表

1. places-text-search：通过文本查询搜索地点，支持多种过滤条件。
2. places-nearby-search：根据地理位置查找附近的地点。
3. place-details：获取特定地点的详细信息。
4. place-autocomplete：根据用户输入提供地点预测。
5. place-photo：获取地点的照片。

常见问题解答

1. 如何设置语言代码？：在输入参数中指定 languageCode 字段。
2. 如何限制搜索结果数量？：使用 maxResultCount 参数。
3. 如何获取地点的照片？：使用 place-photo 工具并提供 photoReference。

使用教程

使用依赖

1. 确保已安装 Node.js 和 npm。
2. 确保已获取 Google Places API 的 API 密钥。

安装教程

1. 克隆项目仓库： bash git clone https://github.com/example/google-places-mcp.git
2. 进入项目目录： bash cd google-places-mcp
3. 安装依赖： bash npm install
4. 配置 API 密钥： bash echo "GOOGLE_PLACES_API_KEY=your_api_key" > .env

调试方式

1. 启动服务： bash npm start
2. 测试文本搜索： bash curl -X POST http://localhost:3000/places-text-search -H "Content-Type: application/json" -d '{"textQuery": "coffee shop"}'
3. 测试附近地点搜索： bash curl -X POST http://localhost:3000/places-nearby-search -H "Content-Type: application/json" -d '{"location": {"latitude": 37.7749, "longitude": -122.4194}}'

许可证

该项目遵循 None 开源许可条款。