Amadeus MCP Server

Amadeus MCP Server

site icon
2025.03.28 0
TypeScript航班搜索旅行规划价格分析金融服务
Amadeus MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,通过连接 Amadeus API 为 AI 助手提供航班搜索、预订和分析功能。该服务适用于旅行规划、航班价格分析、多城市行程规划等场景。
View on GitHub

Overview

基本能力

产品定位

Amadeus MCP Server 是一个专注于航班搜索、预订和价格分析的 MCP 服务,旨在为 AI 助手提供旅行规划支持。

核心功能

  • 航班搜索:支持根据多种参数搜索机场间的航班。
  • 机场信息:通过关键词、城市或国家搜索机场。
  • 价格分析:获取航线的价格指标,判断当前价格高低。
  • 最便宜日期:查找最经济的旅行日期。
  • 航班详情:获取特定航班报价的详细信息。

适用场景

  • 旅行规划
  • 航班价格分析
  • 多城市行程规划
  • 寻找最经济的旅行日期

工具列表

  • search-flights:搜索两个地点之间的航班报价。
  • search-airports:通过关键词、城市名或 IATA 代码搜索机场。
  • flight-price-analysis:获取航线的价格指标。
  • get-flight-details:获取特定航班报价的详细信息。
  • find-cheapest-dates:查找给定航线的最便宜飞行日期。

常见问题解答

  • 如何获取 Amadeus API 凭证?:需要在 .env 文件中配置 AMADEUS_CLIENT_IDAMADEUS_CLIENT_SECRET
  • 如何运行集成测试?:使用 npm run test:integration 命令。
  • 如何处理 API 速率限制?:测试中已包含自动速率限制处理和指数退避机制。

使用教程

使用依赖

  • Node.js 16.x 或更高版本
  • Amadeus API 凭证(Client ID 和 Secret)

安装教程

  1. 克隆仓库:
git clone https://github.com/yourusername/amadeus-mcp-server.git
cd amadeus-mcp-server
  1. 安装依赖:
npm install
  1. 创建 .env 文件并配置 Amadeus API 凭证:
AMADEUS_CLIENT_ID=your_client_id
AMADEUS_CLIENT_SECRET=your_client_secret

运行服务器

构建并启动服务器:

npm run build
npm start

开发模式:

npm run dev

调试方式

运行单元测试:

npx jest

运行测试(观察模式):

npx jest --watch

运行测试(覆盖率):

npx jest --coverage

运行集成测试:

npm run test:integration

运行代码检查:

npm run lint

格式化代码:

npm run format

许可证

该项目遵循 MIT 开源许可条款。