Amadeus MCP Server
Overview
✨ 核心功能
✈️ 航班搜索
检索两个地点之间指定日期的航班选项。
- 由 Amadeus Flight Offers Search API 提供支持
- 需要输入出发地、目的地、票数和旅行日期
🛠️ 工具
get_flight_offers
从 Amadeus Flight Offers Search API 检索航班选项。
参数: | 名称 | 类型 | 必填 | 描述 | 示例 | |-----------------|----------|----------|-----------------------------------------------|----------------| | 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 提供的定价详情。
🚀 快速开始
通过 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/替换为您的项目文件夹的实际路径。
🔧 调试方式
安装完成后，您可以通过以下命令启动服务器:
uv --directory /path/to/project/src/ run --env-file /path/to/project/.env server.py
确保您的 MCP 客户端已正确配置并连接到服务器。