Nearby Search MCP

🚀 附近搜索 MCP 服務器

這是一個基於 IP 地址檢測位置的附近地點搜索 MCP 服務器，能幫助你快速找到附近符合條件的地點，為你的出行和生活提供便利。

🚀 快速開始

本項目是一個基於 IP 地址檢測位置的附近地點搜索 MCP 服務器。使用前，你需要確保滿足一定的需求，並按照特定的步驟進行安裝和配置。

✨ 主要特性

• 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 文件。