NearbySearch MCP Server

基于IP位置检测的附近地点搜索MCP服务器。

特性

• 基于IP的位置检测：使用ipapi.co确定当前位置
• Google Places集成：根据关键词和可选类型过滤器搜索附近的地点
• 简单接口：单个工具端点，支持自定义半径

要求

• Python 3.10+
• 启用了Places API的Google Cloud Platform API密钥
• 网络连接

安装

1. 克隆仓库：

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

2. 安装依赖项：

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

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

3. 客户端配置

{
  "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桌面：

mcp install main.py --name "NearbySearch"

• 直接执行：

python main.py

可用端点

工具：search_nearby

• 搜索您当前位置附近的地点
• 参数：
  • keyword (str): 搜索内容（例如："咖啡店"）
  • radius (int, 可选): 搜索半径，单位米（默认：1500）
  • type (str, 可选): 地点类型（例如："餐厅", "咖啡馆"）

许可证

本项目采用MIT许可证——详情见LICENSE文件。 </中文翻译>