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 功能：

• 机场搜索: 按代码或关键字搜索机场
• 航班搜索: 查找单程和往返旅程的航班
• 价格分析: 获取特定航线的价格指标

集成测试的最佳实践

1. API 速率限制: 测试包括自动速率限制处理和指数退避，以避免 API 限制。 频繁运行测试时，您可能仍然会遇到速率限制。

2. 条件测试: 测试被设计为在缺少 API 凭据时自动跳过，从而允许测试套件在没有凭据的环境中运行而不会出错。

3. 隔离测试: 在开发新功能时，您可以运行特定的测试文件：

   npx jest __tests__/integration/flight-search.test.js
   

4. 更长的超时时间: 集成测试使用更长的超时时间（60 秒）来适应网络延迟和重试。

5. CI/CD 的 Mock: 对于无法访问真实 API 的持续集成管道，请使用 __tests__/amadeus-mock.test.js，它无需实际 API 调用即可运行。

集成

要将此 MCP 服务器与 OpenAI 的 Assistant API 或其他兼容的 AI 系统一起使用，请配置助手以连接到此服务器的端点。

工具

服务器提供以下工具：

search-flights

搜索两个地点之间的航班优惠。

search-airports

按关键字、城市名称或 IATA 代码搜索机场。

flight-price-analysis

获取航线的价格指标，以确定当前价格是高还是低。

get-flight-details

获取有关特定航班优惠的详细信息。

find-cheapest-dates

查找给定航线最便宜的飞行日期。

资源

服务器提供以下模式资源：

• 航班优惠 (schema://flight-offers)
• 机场 (schema://airports)

许可证

MIT