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

1. 安装依赖项：

# Using uv (recommended)
uv add "mcp[cli]" httpx python-dotenv

# Or using 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 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, 可选): 地点类型（例如，“餐厅”，“咖啡馆”）

许可证

此项目根据MIT许可证发布 - 详情请参见LICENSE文件。