Amadeus MCP 服务器

MCP-Amadeus 是一个社区开发的 模型上下文协议 (MCP) 服务器，它与 Amadeus Flight Offers Search API 集成，通过自然语言界面提供航班搜索功能。专为与 MCP 兼容的客户端（例如，Claude Desktop）一起使用而构建。

该项目使用户能够利用大型语言模型 (LLM) 和 Amadeus API 的强大功能，轻松搜索两个地点之间特定日期的航班选项。

本项目使用官方的 amadeus-python SDK

免责声明： 这是一个开源项目，不隶属于 Amadeus IT Group，也未获得其认可。 Amadeus® 是 Amadeus IT Group 的注册商标。

---

✨ 功能

✈️ 航班报价搜索

检索两个地点之间指定日期的航班选项。

“我正在寻找 6 月 15 日从纽约到伦敦的直飞航班，任何航空公司，1 位成人。” → ✈️ 返回可用的航班选项，其中包含出发时间、到达时间、航空公司和价格等详细信息。

• 由 Amadeus Flight Offers Search API 提供支持
• 需要出发地、目的地、机票数量和旅行日期输入

---

🌐 演示

安装并连接到 MCP 兼容的客户端（例如，Claude Desktop）后，此服务器会公开您的 AI 助手可用于获取航班数据的工具。

---

🚀 快速开始

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Amadeus MCP Server：

npx -y @smithery/cli install @donghyun-chae/mcp-amadeus --client claude

1. 克隆和设置

git clone https://github.com/donghyun-chae/mcp-amadeus.git
cd mcp-amadeus-flight-offers

# 安装依赖项（使用 uv 或 pip）
uv sync

2. 获取您的 API 密钥并设置环境

cp .env.example .env

然后编辑 .env 并添加您的 API 凭据：

AMADEUS_CLIENT_ID=your_client_id
AMADEUS_CLIENT_SECRET=your_client_secret

在 https://developers.amadeus.com/ 上注册并创建一个应用程序以获取您的 Client ID 和 Client Secret。

3. 配置 MCP 客户端

在您的 MCP 客户端（例如，Claude for Desktop）中注册此服务器。

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
    "mcpServers": {
        "amadeus": {
            "command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src/",
                "run",
                "--env-file",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/.env",
                "server.py"
            ]
        }
    }
}

将 /ABSOLUTE/PATH/TO/PARENT/FOLDER/ 替换为您的项目文件夹的实际路径。

我的例子：

{
    "mcpServers": {
        "amadeus": {
            "command": "/Users/asena/.local/bin/uv",
            "args": [
                "--directory",
                "/Users/asena/mcp-amadeus/src/",
                "run",
                "--env-file",
                "/Users/asena/mcp-amadeus/.env",
                "server.py"
            ]
        }
    }
}

---

🛠️ 工具

安装后，以下工具将公开给 MCP 客户端：

get_flight_offers

从 Amadeus Flight Offers Search API 检索航班报价。

请求：

{
  "action": "tool",
  "name": "get_flight_offers",
  "params": {
  "origin": "JFK",
  "destination": "LHR",
  "departure_date": "2025-06-15"
  }
}

参数：

名称	类型	必需	描述	示例
origin	string	是	出发城市/机场的 IATA 代码	JFK
destination	string	是	目的地城市/机场的 IATA 代码	LHR
departure_date	string	是	出发日期 (YYYY-MM-DD)	2025-06-15
return_date	string	否	返回日期 (YYYY-MM-DD)。如果省略则为单程	2025-06-20
adults	integer	是	成人数 (1-9)。默认值：1	2
children	integer	否	儿童数 (2-11)。最大总数：9	1
infants	integer	否	婴儿数 (≤2)。最大值：# 成人数	1
travel_class	string	否	舱位等级：ECONOMY、BUSINESS 等。	ECONOMY
non_stop	boolean	否	如果为 true，则仅限直飞航班。默认值：false	true
currency_code	string	否	ISO 4217 中的货币（例如，USD）	EUR
max_price	integer	否	每位旅客的最高价格	500
max	integer	否	最大报价数。默认值：250	10

输出： 以 JSON 格式返回航班报价，其中包含来自 Amadeus 的航空公司、时间、持续时间和定价详细信息。

---

📚 参考

• 模型上下文协议 Python SDK
• Amadeus Python SDK
• Amadeus API 文档

---

📝 许可证

MIT 许可证 © 2025 donghyun-chae