Amadeus MCP Server

Amadeus MCP サーバー

これは、Amadeus API に接続し、AI アシスタントにフライトの検索、予約、分析機能を提供する Model Context Protocol（MCP）サーバーです。

機能

• フライト検索：さまざまな条件を指定して、空港間のフライトを検索します
• 空港情報：キーワード、都市、国から空港を検索します
• 料金分析：ルートの料金指標を取得し、現在の料金が高いか安いかを判断します
• 最安日：最もお得に旅行できる日を検索します
• フライトの詳細：特定のフライトオファーに関する詳細情報を取得します

プロンプト

このサーバーでは、よくある旅行計画のシナリオ向けに、事前設定済みのプロンプトをいくつか提供しています。

1. フライト料金を分析（analyze-flight-prices）：料金の傾向に関する分析情報を添えて、ルートのフライト料金を分析します
2. お得なフライトを検索（find-best-deals）：特定のルートと日付で最もお得なフライトを検索します
3. 複数都市の旅行を計画（plan-multi-city-trip）：最適なルートで、複数都市を巡る旅程全体を計画します
4. 最安の旅行日を検索（find-cheapest-travel-dates）：最もお得に旅行できる日を特定します

セットアップ

前提条件

• Node.js 16.x 以上
• Amadeus API の認証情報（Client ID と Secret）

インストール

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

git clone https://github.com/yourusername/amadeus-mcp-server.git
cd amadeus-mcp-server

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

npm install

3. ルートディレクトリに Amadeus API の認証情報を記載した .env ファイルを作成します：

AMADEUS_CLIENT_ID=your_client_id
AMADEUS_CLIENT_SECRET=your_client_secret

サーバーの実行

サーバーをビルドして起動します：

npm run build
npm start

開発時：

npm run dev

テストと開発

このプロジェクトでは、テストに Jest、リンティングとフォーマットに Biome を使用しています。

単体テストを実行します：

npx jest

ウォッチモードでテストを実行します：

npx jest --watch

カバレッジ付きでテストを実行します：

npx jest --coverage

統合テストを実行します（Amadeus API の認証情報が必要です）：

npm run test:integration

リンティングを実行します：

npm run lint

コードをフォーマットします：

npm run format

統合テスト

このプロジェクトには、実際の Amadeus API に対するサーバーの動作を検証する包括的な統合テストが含まれています。これらのテストは、API クライアントが実際の API エンドポイントと正しく連携し、応答を適切に処理することを確認するのに役立ちます。

統合テストの要件

• Amadeus API の認証情報：テストを実行するには、.env ファイルに有効な Amadeus API の認証情報が必要です：

  AMADEUS_CLIENT_ID=your_client_id
  AMADEUS_CLIENT_SECRET=your_client_secret
  

• テスト環境：テストでは本番 API ではなく、Amadeus のテスト環境を使用するように設定されています。

統合テストの実行

npm run test:integration

統合テストは __tests__/integration にあり、次の API 機能を検証します：

• 空港検索：コードまたはキーワードで空港を検索します
• フライト検索：片道および往復の旅程のフライトを検索します
• 料金分析：特定のルートの料金指標を取得します

統合テストのベストプラクティス

1. API のレート制限：テストには、API のスロットリングを回避するための指数バックオフによる自動レート制限処理が含まれています。テストを頻繁に実行すると、レート制限に達する場合があります。

2. 条件付きテスト：認証情報がない場合、テストは自動的にスキップされるよう設計されています。そのため、認証情報のない環境でも、テストスイートをエラーなく実行できます。

3. 個別にテスト：新機能の開発時には、特定のテストファイルを実行できます：

   npx jest __tests__/integration/flight-search.test.js
   

4. 長めのタイムアウト：統合テストでは、ネットワーク遅延や再試行に対応するため、長めのタイムアウト（60 秒）を使用します。

5. CI/CD ではモックを使用：実際の API にアクセスできない継続的インテグレーションのパイプラインでは、実際の API 呼び出しを行わずに実行できる __tests__/amadeus-mock.test.js を使用してください。

統合

この MCP サーバーを OpenAI の Assistant API やその他の互換性のある AI システムで使用するには、アシスタントがこのサーバーのエンドポイントに接続するよう設定してください。

ツール

このサーバーでは、次のツールを提供しています：

search-flights

2 つの場所の間のフライトオファーを検索します。

search-airports

キーワード、都市名、または IATA コードで空港を検索します。

flight-price-analysis

フライトルートの料金指標を取得し、現在の料金が高いか安いかを判断します。

get-flight-details

特定のフライトオファーに関する詳細情報を取得します。

find-cheapest-dates

指定された路線で最も安く飛行機を利用できる日付を検索します。

リソース

サーバーは、以下のスキーマリソースを提供します。

• フライトオファー（schema://flight-offers）
• 空港（schema://airports）

ライセンス

MIT