谷歌放置MCP服务器
此MCP服务器与Google Places API集成,允许搜索、检索详细信息和查找附近的位置。
设置
环境变量
需要以下环境变量:
GOOGLE_MAPS_API_KEY:您的Google Maps API密钥已启用Places API访问TRANSPORT_TYPE:使用的运输方式(stdio或sse)PORT:(可选)SSE传输的端口号(默认值:3000)
创建一个 .env 根目录中的文件包含以下变量:
GOOGLE_MAPS_API_KEY=your_api_key_here
PORT=3000发展
- 安装依赖项:
npm install- 启动开发服务器:
npm run dev运输选项
服务器支持两种传输方式:
- SSE(服务器发送事件):使用HTTP与服务器发送的事件进行实时通信
使用SSE传输时,服务器会公开两个端点:
GET /sse:用于接收服务器消息的SSE端点POST /messages:用于向服务器发送消息的端点
工具
- \[x\] 放置文本搜索
- 使用Google places API搜索地点的文本 - 输入: - textQuery (string,必填):用于搜索地点的文本查询 - includedType (字符串,可选):将结果限制在与指定类型匹配的位置 - includePureServiceAreaBusinesses (布尔值,可选):包括没有实际位置的企业 - languageCode (字符串,可选):结果的语言代码(例如“en”) - locationBias (对象,可选):将结果偏向此位置 - locationRestriction (对象,可选):将结果限制在此位置 - pageSize (数字,可选):每页结果数(1-20) - pageToken (字符串,可选):下一页结果的标记 - priceLevels (数组,可选):按价格级别筛选 - rankPreference (字符串,可选):按“相关性”或“距离”进行排名 - regionCode (字符串,可选):两个字符的国家/地区代码 - strictTypeFiltering (boolean,可选):仅返回完全匹配的类型 - evOptions (对象,可选):电动汽车充电站过滤器 - minRating (数字,可选):最小额定值过滤器(0-5) - openNow (布尔值,可选):筛选当前打开的位置 - fields (数组,可选):响应中要包含的特定字段 - 返回匹配的地点及其详细信息
- \[ \] 附近地点搜索 (即将推出)
- 查找特定位置附近的地点 - 输入: - location (对象,必填):经纬度坐标 - radius (数字,可选):搜索半径(单位:米) - keyword (字符串,可选):用于筛选结果的关键字 - type (字符串,可选):放置类型以过滤结果 - rankBy (字符串,可选):按“突出度”或“距离”排名 - openNow (boolean,可选):筛选当前打开的地点 - fields (数组,可选):要包含在响应中的特定字段 - 返回附近的详细地点
- \[ \] 地点详细信息 (即将推出)
- 获取特定地点的详细信息 - 输入: - placeId (字符串,必填):谷歌地点ID - fields (数组,可选):要包含在响应中的特定字段 - languageCode (字符串,可选):结果的语言代码 - 返回有关该地点的全面详细信息
- \[ \] 地点照片 (即将推出)
- 检索某个地点的照片 - 输入: - photoReference (字符串,必填):来自Place Details响应的引用 - maxWidth (数字,可选):返回图像的最大宽度 - maxHeight (数字,可选):返回图像的最大高度 - 返回照片数据或URL
