NearbySearch MCP Server

基本能力

产品定位

NearbySearch MCP Server 是一个基于IP定位的附近地点搜索服务，主要用于帮助用户快速找到附近的兴趣点。

核心功能

• IP-based Location Detection: 使用ipapi.co确定当前位置
• Google Places Integration: 基于关键词和可选类型过滤器搜索附近地点
• Simple Interface: 单一工具端点，可自定义搜索半径

适用场景

• 需要快速查找附近商业设施（如餐厅、咖啡馆等）
• 基于用户当前位置提供个性化推荐
• 位置感知应用的开发

工具列表

• search_nearby: 搜索当前位置附近的场所
• 参数:
  • keyword (str): 搜索关键词（如"coffee shop"）
  • radius (int, 可选): 搜索半径（米，默认1500）
  • type (str, 可选): 场所类型（如"restaurant", "cafe"）

常见问题解答

• 需要Google Cloud Platform API Key并启用Places API
• 需要Python 3.10+环境
• 需要互联网连接

使用教程

使用依赖

• Python 3.10+
• Google Cloud Platform API Key（需启用Places API）
• 互联网连接

安装教程

1. 克隆仓库:

git clone https://github.com/kukapay/nearby-search-mcp.git
cd nearby-search-mcp

1. 安装依赖:

# 使用uv（推荐）
uv add "mcp[cli]" httpx python-dotenv

# 或使用pip
pip install mcp httpx python-dotenv

1. 客户端配置

{
  "mcpServers": {
    "nearby-search": {
      "command": "uv",
      "args": ["--directory", "path/to/nearby-search-mcp", "run", "main.py"],
      "env": {
        "GOOGLE_API_KEY": "your google api key"
      }
    }
  }
}

调试方式

• 开发模式（带MCP检查器）:

mcp dev main.py

• 在Claude Desktop中安装:

mcp install main.py --name "NearbySearch"

• 直接执行:

python main.py

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。