附近搜索 MCP 服务器

一个基于 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": "你的 Google API 密钥"
      }
    }
  }
}

使用方法

运行服务器

• 开发模式（带 MCP Inspector）：

mcp dev main.py

• 在 Claude Desktop 中安装：

mcp install main.py --name "NearbySearch"

• 直接执行：

python main.py

可用端点

工具：search_nearby

• 根据当前位置搜索附近的地点
• 参数：
  • keyword (str): 要搜索的内容（例如“咖啡馆”）
  • radius (int, optional): 搜索半径，单位为米（默认：1500）
  • type (str, optional): 地点类型（例如“餐厅”，“咖啡馆”）

许可证

本项目采用 MIT License，有关详细信息请参阅 LICENSE 文件。