Amadeus Agent

🚀 旅行エージェント

Amadeus用のシンプルな概念実証MCPサーバーです。これにより、LLMベースのエージェントがAmadeusをツールとして利用できます。 このサーバーは、LLMが世界中の航空券予約情報を直接照会するためのツールを提供します。具体的には以下の情報を取得できます。

• 特定の旅程の最安値航空券
• 特定の空港からのすべての目的地
• 特定の航空会社のすべての路線

✨ 主な機能

🔍 MCPとは？

Model Context Protocol (MCP) は、LLMエージェントがツール、リソース、プロンプトとやり取りするためのクライアント - サーバープロトコルです。エージェント用のHTTPと考えることができます。MCPサーバーは、エージェントがユーザーのタスクを実行するために使用できる一連のツールをホストします。

🔍 Amadeusとは？

Amadeusはグローバル配布システム (GDS) で、世界中の多くの旅行代理店が使用する予約システムです。これを使用すると、旅行代理店やその他の再販業者のみが直接利用できる航空券と予約情報を照会できます。

📚 ドキュメント

🏗️ 構造

- agent
--- resources   <- 静的データ
--- services    <- ツールロジックのサービス層
--- tools       <- LLMに提供される実際のツール
server.py       <- メインサーバーエンドポイント

📦 インストール

このプロジェクトはPythonの uv プロジェクトマネージャー uv に依存しており、これにより依存関係の管理と配布が容易になります。uv をインストールしたら、プロジェクトを実行するためのすべての依存関係を含む仮想環境を作成できます。

uv install

source .venv/bin/activate

インストールが完了したら、プロジェクトのルートディレクトリに .env ファイルを作成し、Amadeus for developersの資格情報を提供する必要があります。Amadeusの開発者ページでキーの取得方法が説明されています。キーとシークレットを取得したら、次のように .env ファイルに記述します。

AMADEUS_ENV="test"
AMADEUS_KEY=<YOUR-KEY>
AMADEUS_SECRET=<YOUR-SECRET>

💻 使用例

基本的な使用法

セットアップが完了したら、FastMCP サーバーを起動できます。

python server.py

これで、LLMエージェントからのリクエストを受け付ける準備ができました。

高度な使用法

Claude Desktopへの接続

Claude DesktopはMCPサーバーとのやり取りをサポートしています。これを有効にするには、Claude Desktopの開発者パネルを開き、claude_desktop_config.json を編集してサーバーを起動します。

{
  "mcpServers": {
    "AmadeusServer": {
      "command": "<PATH-TO-PROJECT>/.venv/bin/python",
      "args": [
        "<PATH-TO-PROJECT>/server.py"
      ]
    }
  }
}

その後、Claude Desktopを再起動して新しい会話を開始します。テキスト入力欄の下の設定パネルから AmadeusServer を選択します。

これでClaudeはツールを検出し、タスクを解決するために使用するはずです。