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 憑證：測試需要有效的 Amadeus API 憑證在 .env 文件中：

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