使用说明
餐厅查找器MCP服务器
MCP服务器，可帮助您使用Google Maps API查找餐馆。按位置或沿路线搜索详细信息，包括评论、美食类型、定价和直接谷歌地图链接。
特性
- 按地点查找餐厅：搜索任何地址、城市或坐标附近的餐馆
- 沿途寻找餐厅：探索沿途的餐饮选择
- 详细信息：获取评级、评论、菜肴类型、价格水平和谷歌地图链接
- 定制搜索：调整搜索半径、绕行距离和结果限制
设置
1.获取Google Maps API密钥
- 首选 谷歌云控制台
- 创建新项目或选择现有项目
- 启用以下API：
- 地点API
- API指南
- 地理编码API
- 创建凭据（API密钥）
- 复制API密钥
2.安装MCP服务器
# Install using uv (recommended)
uv pip install -e .
# Or using pip
pip install -e .
3.配置API密钥
快速设置（推荐）：
在macOS/Linux上：
chmod +x setup_api_key.sh
./setup_api_key.sh
在Windows（PowerShell）上：
.\setup_api_key.ps1
在Windows上（命令提示符）：
setup_api_key.bat
手动设置：
使用API密钥在主目录中创建一个文件：
在macOS/Linux上：
# Create the API key file
echo "YOUR_API_KEY_HERE" > ~/.env.googleapi
# Or edit it manually
nano ~/.env.googleapi
在Windows（PowerShell）上：
# Create the API key file
"YOUR_API_KEY_HERE" | Out-File -FilePath "$env:USERPROFILE\.env.googleapi" -Encoding ASCII
# Or edit it manually
notepad "$env:USERPROFILE\.env.googleapi"
在Windows上（命令提示符）：
echo YOUR_API_KEY_HERE > %USERPROFILE%\.env.googleapi
notepad %USERPROFILE%\.env.googleapi
替换 YOUR_API_KEY_HERE 使用您的实际谷歌地图API密钥。
文件位置：
- macOS/Linux：
~/.env.googleapi（例如。，/Users/yourname/.env.googleapi) - 窗户：
%USERPROFILE%\.env.googleapi（例如。，C:\Users\yourname\.env.googleapi)
安全说明：API密钥存储在主目录中（不在存储库或mcp.json中），以提高安全性。
4.在Kiro中配置
添加到您的 .kiro/settings/mcp.json:
{
"mcpServers": {
"restaurant-finder": {
"command": "python3",
"args": ["/absolute/path/to/gm-restaurant-mcp/restaurant_finder_mcp/server.py"],
"disabled": false,
"autoApprove": []
}
}
}
替换 /absolute/path/to/gm-restaurant-mcp 你的实际路径。
备注：mcp.json中不需要API密钥-它是从 ~/.env.googleapi 自动。
用法
按地点查找餐厅
Find restaurants near Times Square, New York
沿途寻找餐厅
Find restaurants along the route from Boston to New York City
🚀 优化和免费等级
此MCP包括内置优化，可帮助您保持在谷歌每月200美元的免费范围内：
自动功能
- 24小时缓存：重复搜索是免费的
- 使用跟踪：监控API调用和成本
- 智能批处理：高效的请求处理
检查您的使用情况
Get usage stats
退货：
- 本月API调用总数
- 估计成本
- 剩余免费信贷
- 缓存命中率
- 节省成本
快速设置
chmod +x setup_optimization.sh
./setup_optimization.sh
留在免费等级内
- ✅ 典型个人使用：约15美元/月（92.5%低于限额）
- ✅ 缓存可将成本降低约50%
- ✅ $200学分=每月约28500次餐厅搜索
阅读 优化_ GIDE.md 获取详细的提示和最佳实践。
工具
find_restaurants_by_location
搜索特定地点附近的餐馆。
参数：
location（必填）：地址、城市或坐标radius（可选）：搜索半径（单位：米）（默认值：1500）max_results（可选）：返回的最大结果数（默认值：10）
find_restaurants_along_route
在两个地点之间的路线上寻找餐馆。
参数：
origin（必填）：起始位置destination（必填）：结束位置detour_distance（可选）：以米为单位的路线最大绕行距离（默认值：2000）max_results（可选）：返回的最大结果数（默认值：10）
响应格式
每家餐厅包括：
- 姓名与地址
- 评级和评级总数
- 价格水平（$至$$$）
- 菜肴类型
- 前3条评论，包括评分和摘录
- 直接谷歌地图URL
备注
- 需要有效的Google Maps API密钥，并启用位置和方向API
- API的使用可能会产生基于谷歌定价的成本
- 为了可读性，审阅文本被截断为200个字符
