NearbySearch MCP Server
基于IP定位的附近地点搜索MCP服务器。
功能
- IP定位检测：使用ipapi.co确定您的当前位置
- Google Places集成：根据关键词和可选的类型过滤器搜索附近地点
- 简洁界面：单一工具端点，支持自定义搜索半径
要求
- Python 3.10+
- 已启用Places API的Google Cloud Platform API密钥
- 网络连接
安装
- 克隆仓库：
git clone https://github.com/kukapay/nearby-search-mcp.git
cd nearby-search-mcp
- 安装依赖：
# 使用uv（推荐）
uv add "mcp[cli]" httpx python-dotenv
# 或使用pip
pip install mcp httpx python-dotenv
- 客户端配置
{
"mcpServers": {
"nearby-search": {
"command": "uv",
"args": ["--directory", "path/to/nearby-search-mcp", "run", "main.py"],
"env": {
"GOOGLE_API_KEY": "your google api key"
}
}
}
}
使用
运行服务器
- 开发模式（配合MCP Inspector）：
mcp dev main.py
- 在Claude Desktop中安装：
mcp install main.py --name "NearbySearch"
- 直接执行：
python main.py
可用端点
工具：search_nearby
- 搜索您当前位置附近的地点
- 参数：
keyword(str)：搜索内容（例如，"咖啡店"）radius(int, 可选)：搜索半径（单位：米，默认：1500）type(str, 可选)：地点类型（例如，"餐厅"、"咖啡馆"）
许可证
本项目根据MIT许可证授权 - 详细内容请参阅LICENSE文件。