Yelp MCP

🚀 Yelp Fusion AI用MCPサーバー

Yelp Fusion AI は、アプリケーションに会話型インテリジェンスをもたらします。ユーザーは自然言語で質問を行い、Yelpの最新のビジネスデータとレビューに基づいたリアルタイムで文脈に関連した回答を受け取ることができます。

✨ 主な機能

Fusion AIの機能

• 次世代の検索と発見 – 自然言語で検索し、文脈に関連したビジネスを発見し、接続することができます。 （例："Find the best tacos in the Bay Area"）
• マルチターン会話 – 双方向の対話をサポートし、フォローアップの質問でクエリを絞り込むことができます。 （例："Which of the options have open air seating?"）
• 直接のビジネスクエリ – 事前の検索を行わずに、ビジネスに関するターゲット化された質問をすることができます。 （例："Does Ricky’s Taco allow pets?"）
• 会話型レストラン予約 – 自然言語対話を通じて、レストランの空き状況を確認し、テーブルを予約することができます。（この機能はリクエストによりのみ利用可能です。予約機能を有効にするには、こちらからお問い合わせください。） （例："Reserve a table for 4 tomorrow at 8PM at Ricky’s"）

ツール

このサーバーは、主に1つのツールを公開しています。

• yelp_agent：エージェント間通信を目的として設計されています。このツールは、地元のビジネスに関する自然言語リクエストを処理し、自然言語の応答と構造化されたビジネスデータの両方を提供します。chat_idを使用したフォローアップの質問にも対応しています。機能には、ビジネス検索、詳細な質問、比較、旅行計画の作成などが含まれ、Yelpのデータセットを活用しています。 主な引数:
  • natural_language_query (str)：クエリ（例："find the best tacos in the Bay Area"）。
  • search_latitude (float or null)：場所固有の検索に使用する緯度。
  • search_longitude (float or null)：場所固有の検索に使用する経度。
  • chat_id (str or null)：前の会話を続けるためのID。

📦 インストール

前提条件

コンテナマネージャー（Docker または Podman など）が必要です。または、以下をローカルにインストールする必要があります。

• Python：バージョン3.10以上（pyproject.tomlで指定）。
• uv：Pythonパッケージマネージャー。インストール手順は https://docs.astral.sh/uv/ を参照してください。

また、Yelp Fusion AIのAPIキーが必要です。ここでアプリを作成 することで、無料トライアルを開始することができます。評価にもっと時間が必要な場合は、fusion@yelp.com までメールを送り、トライアルを延長してください。 Yelp Fusion AIに関する詳細と包括的なドキュメントはこちら で確認できます。

セットアップとインストール

1. リポジトリをクローンします。

git clone <repository_url>
cd yelp-mcp

2. 依存関係をインストールします。このコマンドは、仮想環境が存在しない場合は作成し、pyproject.tomlとuv.lockで定義されたすべての必要な依存関係をインストールし、プロジェクトをuv環境にインストールします。

make install

Dockerイメージのビルド（オプション）

サーバーをコンテナで実行する場合は、Dockerイメージをビルドすることができます。

docker build -t mcp-yelp-agent .

これにより、mcp-yelp-agent:latestという名前のイメージが作成されます。

💻 使用例

サーバーの実行

このリポジトリは、Model Context Protocolサーバー として実行するように設計されています。MCPクライアント（Claude、Cursor、またはMCPをサポートするVS Codeなどの互換バージョン）が必要です。

方法1：Dockerを使用せずに実行

「セットアップとインストール」の手順を完了していることを確認してください。特に、プロジェクトをインストールし、mcp-yelp-agentスクリプトが使用可能であることを確認してください。

サーバーの構成

サーバーは複数のトランスポートプロトコルをサポートしており、コマンドライン引数で構成することができます。ほとんどのMCPクライアントでは、stdio が主要なトランスポートですが、他のオプションも異なるユースケースに利用できます。

• --transport：通信プロトコルを選択します。
  • stdio（デフォルト）：標準入出力。ローカルツールに最適です。
  • streamable-http：ストリーム可能なHTTP。
  • sse：Server-Sent Events。
• --host：バインドするホストアドレス（例：127.0.0.1 または 0.0.0.0）。デフォルトは 127.0.0.1 です。
• --port：リッスンするポート。デフォルトは 8000 です。

MCPクライアントを以下のJSON設定で構成し、デフォルトの stdio トランスポートでサーバーを実行します。

{
  "mcpServers": {
    "yelp_agent": {
      "command": "uv",
      "args": [
        "--directory",
        "<PATH_TO_YOUR_CLONED_PROJECT_DIRECTORY>",
        "run",
        "mcp-yelp-agent"
      ],
      "env": {
        "YELP_API_KEY": "<YOUR_YELP_FUSION_API_KEY>"
      }
    }
  }
}

注意事項:

• <PATH_TO_YOUR_CLONED_PROJECT_DIRECTORY> を、このプロジェクトをクローンした絶対パスに置き換えてください。
• <YOUR_YELP_FUSION_API_KEY> を、実際のYelp Fusion APIキーに置き換えてください。
• MCPクライアントがuvを直接呼び出すことができない場合は、uvバイナリの完全パスを指定する必要がある場合があります。ターミナルで which uv を実行することで、このパスを見つけることができます。

方法2：Dockerを使用して実行

「Dockerイメージのビルド」で説明したように、Dockerイメージをビルドしていることを確認してください。 MCPクライアントを以下のJSON設定で構成します。

{
  "mcpServers": {
    "yelp_agent": {
      "command": "docker",
      "args": [
        "run",
        "-i",          // インタラクティブモード
        "--rm",        // コンテナが終了したときに自動的に削除する
        "--init",      // コンテナ内でPID 1としてinitプロセスを実行する
        "-e", "YELP_API_KEY=<YOUR_YELP_FUSION_API_KEY>",
        "mcp-yelp-agent:latest" // 先にビルドしたイメージ名
      ]
    }
  }
}

注意事項:

• <YOUR_YELP_FUSION_API_KEY> を、実際のYelp Fusion APIキーに置き換えてください。
• MCPクライアントがシステムパスからdockerを呼び出すことができない場合は、そのバイナリの完全パスを指定する必要がある場合があります（例：which dockerを実行）。