Amadeus MCP Server Standalone

🚀 Amadeus MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）サーバーで、Amadeus APIに接続し、AIアシスタントにフライト検索、予約、分析機能を提供します。

✨ 主な機能

• フライト検索：異なる空港間のフライトとその様々なパラメータを検索します。
• 空港情報：キーワード、都市、または国を使って空港を検索します。
• 価格分析：航空路線の価格指標を取得し、現在の価格が高いか低いかを判断します。
• 最安日：旅行に最も経済的な日を見つけます。
• フライト詳細：特定のフライトの詳細情報を取得します。

📚 ドキュメント

プロンプト

このサーバーは、一般的な旅行計画シナリオに使用するためのいくつかの事前設定されたプロンプトを提供しています。

1. フライト価格の分析 (analyze-flight-prices)：航空路線のフライト価格の傾向と洞察を分析します。
2. 最適な割引を見つける (find-best-deals)：特定の航空路線と日付に対する最適なフライト割引を見つけます。
3. 多都市旅行の計画 (plan-multi-city-trip)：完全な多都市旅行を計画し、ルートを最適化します。
4. 最安の旅行日を見つける (find-cheapest-travel-dates)：旅行に最も経済的な日を特定します。

📦 インストール

前提条件

• Node.js 16.x以上
• Amadeus APIの認証情報（クライアントIDとシークレットキー）

インストール手順

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

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

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

npm install

3. プロジェクトのルートディレクトリに.envファイルを作成し、Amadeus APIの認証情報を追加します。

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
  

• テスト環境：テストは、Amadeusのテスト環境を使用するように設定されており、本番用APIではありません。

統合テストの実行

npm run test:integration

統合テストは__tests__/integrationディレクトリにあり、以下のAPI機能を検証します。

• 空港検索：コードまたはキーワードで空港を検索します。
• フライト検索：片道と往復のフライトを検索します。
• 価格分析：特定の航空路線の価格指標を取得します。

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

⚠️ 重要提示

• テスト時には、Amadeus APIのレート制限に注意し、クォータを超えないようにしてください。
• テストを実行する際には、.envファイルの認証情報が正しく設定されていることを確認してください。
• 定期的にプロジェクトの依存関係をチェックして更新し、互換性を維持してください。

📄 ライセンス

MIT