NearbySearch MCP Server

NearbySearch MCP サーバー

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

2. 依存関係をインストールします：

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

# Or using 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）：検索する対象（例：「coffee shop」）
  • radius（int、任意）：検索半径（メートル単位、デフォルト：1500）
  • type（str、任意）：場所の種類（例：「restaurant」、「cafe」）

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については、LICENSE ファイルを参照してください。