NearbySearch MCP 服务器

一个用于附近地点搜索的 MCP 服务器，使用基于 IP 的位置检测。

功能特性

• 基于 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 Desktop:

mcp install main.py --name "NearbySearch"

• 直接执行:

python main.py

可用端点

工具: search_nearby

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

许可证

本项目基于 MIT 许可证 - 详情请查看 LICENSE 文件。