近隣検索MCPサーバー

IP ベースの位置検出を使用して近くの場所を検索するための MCP サーバー。

特徴

• IPベースの位置検出：ipapi.coを使用して現在地を特定します

• Googleプレイス統合: キーワードとオプションのタイプフィルターに基づいて近くの場所を検索します

• シンプルなインターフェース: 半径をカスタマイズできる単一のツールエンドポイント

Related MCP server: MCP Hub Tools

要件

• 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

利用可能なエンドポイント

ツール:

• 現在地近くの場所を検索します

• パラメータ:

  • keyword (str): 検索対象 (例: 「コーヒーショップ」)

  • radius (int, オプション): 検索半径（メートル単位）（デフォルト: 1500）

  • type (str, オプション): 場所の種類 (例: "restaurant"、"cafe")

ライセンス

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