Amadeus Agent

🚀 旅行代理

這是一個簡單的概念驗證MCP服務器，專為Amadeus設計，可讓基於大語言模型（LLM）的代理將Amadeus用作工具。該服務器為大語言模型提供了直接查詢全球實時航班預訂信息的工具，具體包括：

• 特定旅程的最便宜機票。
• 特定機場的所有目的地。
• 某家航空公司的所有航線。

🚀 快速開始

本項目可讓大語言模型藉助Amadeus查詢全球航班預訂信息，為用戶提供旅行相關的服務。

✨ 主要特性

• 實時航班信息查詢：能夠查詢特定旅程的最便宜機票、特定機場的所有目的地以及某家航空公司的所有航線。
• 與大語言模型集成：通過MCP協議，可讓大語言模型將其作為工具使用，為用戶解決旅行相關問題。

📚 詳細文檔

什麼是MCP？

模型上下文協議（Model Context Protocol，MCP）是一種用於大語言模型代理與工具、資源和提示進行交互的客戶端 - 服務器協議。你可以將其視為代理的HTTP協議。MCP服務器託管了一系列工具，代理可以使用這些工具為用戶執行任務。

什麼是Amadeus？

Amadeus是一個全球分銷系統（Global distribution system，GDS），本質上是一個預訂和票務系統，被全球大量旅行社使用。它允許查詢只有旅行社和其他經銷商才能直接獲取的航班和預訂信息。

🏗️ 項目結構

- agent
--- resources   <- 靜態數據
--- services    <- 工具邏輯的服務層
--- tools       <- 提供給大語言模型的實際工具
server.py       <- 主服務器端點

📦 安裝指南

本項目依賴於Python的uv項目管理器 uv，它可以輕鬆進行依賴管理和分發。安裝uv後，你可以創建一個包含所有依賴項的虛擬環境來運行項目。

uv install

source .venv/bin/activate

安裝完成後，你需要在項目根目錄的.env文件中提供Amadeus開發者憑證。Amadeus開發者頁面會告訴你如何獲取此類密鑰。獲取密鑰和密鑰後，將它們放在.env文件中，如下所示：

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

💻 使用示例

啟動服務器

設置完成後，你可以啟動 FastMCP 服務器。

python server.py

此時，服務器已準備好接受大語言模型代理的請求。

連接到Claude桌面版

Claude桌面版內置了與MCP服務器交互的支持。要啟用此功能，你需要打開Claude桌面版開發者面板，並編輯claude_desktop_config.json以啟動服務器。

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

然後重啟Claude桌面版並開始新對話。在輸入文本之前，從文本輸入下方的配置面板中選擇AmadeusServer。

此時，Claude應該能夠發現你的工具並使用它們來解決你的任務。