nearby-search-mcp

🚀 附近搜索 MCP 服务器

本项目是一个基于 IP 地址检测位置的附近地点搜索 MCP 服务器，能借助 IP 定位，结合 Google Places 服务，帮你快速找到附近符合条件的地点。

✨ 主要特性

• IP 地址位置检测：使用 ipapi.co 确定当前位置。
• Google Places 整合：根据关键字和可选类型筛选搜索附近的地点。
• 简单界面：单个工具端点，带有自定义半径选项。

📦 安装指南

克隆仓库

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": "你的 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 文件。