Nearby Search MCP

NearbySearch MCP服务器

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

特性

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

需求

• Python 3.10+
• 启用地点API的Google云平台API密钥
• Internet连接

安装

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检查员一起）：

mcp dev main.py

• 在Claude桌面中安装:

mcp install main.py --name "NearbySearch"

• 直接执行:

python main.py

可用端点

工具： search_nearby

• 搜索您当前位置附近的地点
• 参数：

- keyword （str）：搜索什么（例如，“咖啡店”） - radius （int，可选）：搜索半径，单位为米（默认值：1500） - type （str，可选）：地点类型（例如“餐厅”、“咖啡馆”）

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。