Nearby Search MCP

🚀 近隣検索 MCP サーバー

このサーバーは、IP アドレスに基づいて位置を検出し、近隣の場所を検索する MCP サーバーです。

🚀 クイックスタート

近隣検索 MCP サーバーは、IP アドレスを使って位置を特定し、近くの場所を検索することができます。以下に、サーバーのセットアップと使用方法を説明します。

✨ 主な機能

• IP アドレス位置検出：ipapi.co を使用して現在位置を特定します。
• Google Places 統合：キーワードとオプションのタイプで近隣の場所を絞り込んで検索します。
• シンプルなインターフェース：単一のツールエンドポイントで、カスタム半径オプション付きです。

📦 インストール

1. リポジトリのクローン

git clone https://github.com/kukapay/nearby-search-mcp.git
cd nearby-search-mcp

2. 依存関係のインストール

# uv を使用する場合（推奨）
uv add "mcp[cli]" httpx python-dotenv

# 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": "あなたの 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 ファイルを参照してください。