旅行API服务

Name: 旅行API服务
Author: Prathush21

一个提供Amadeus旅行API访问的模型上下文协议(MCP)服务器，支持航班搜索、酒店预订、活动查询等全方位旅行数据服务。

by Prathush21
JavaScript
本地部署
更新于 2025.11.10

在 GitHub 查看 Prathush21/travel-amadeus-mcp

使用说明

Amadeus MCP旅行服务器

一个模型上下文协议（MCP）服务器，提供对所有Amadeus Travel API的访问。这使得人工智能助手能够搜索航班、预订酒店、查找活动并访问全面的旅行数据。

特性

航班API

航班搜索 -搜索具有灵活日期和路线的航班优惠
航班预订 -创建、检索和取消航班订单
飞行灵感 -从出发地查找最便宜的目的地
航班可用性 -高级可用性搜索
座位图 -查看航班上的可用座位
品牌票价 -通过额外服务获得追加销售选项
航班状态 -实时航班跟踪

酒店API

酒店搜索 -按城市或坐标查找酒店优惠
酒店预订 -预订酒店房间
酒店列表 -按城市或地点列出酒店
酒店情绪 -获取评论情绪分析

活动和兴趣点

活动搜索 -按地点查找旅游和活动
兴趣点 -探索旅游景点
活动详情 -获取详细的活动信息

传递服务

转账搜索 -查找私人转账选项
转账预订 -预订地面交通
转账取消 -取消接送预订

旅游情报

旅游分析 -预订/旅行最多的目的地，最繁忙的时期
价格分析 -航班价格指标和四分位数分布
预测 -航班延误、旅行目的、准点率
位置分数 -安全和旅游评级

参考数据

位置搜索 -查找机场和城市（自动完成）
航空公司查询 -获取航空公司信息
签入链接 -航空公司值机URL
路由信息 -机场和航线

安装

克隆存储库：

git clone <repository-url>
cd travel-amadeus-mcp

安装依赖项：

npm install

获取您的Amadeus API证书：
- 注册地址： Amadeus开发者版
- 创建一个新应用程序以获取您的API密钥（客户端ID）和API密钥（客户端密钥）
配置环境变量：

cp .env.example .env
# Edit .env and add your credentials

构建项目：

npm run build

配置

环境变量

创建一个 .env 文件包含以下内容：

AMADEUS_CLIENT_ID=your_client_id_here
AMADEUS_CLIENT_SECRET=your_client_secret_here
AMADEUS_HOSTNAME=production  # or "test" for testing

Claude桌面配置

添加到您的Claude Desktop配置文件中：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "amadeus": {
      "command": "node",
      "args": ["/absolute/path/to/travel-amadeus-mcp/dist/index.js"],
      "env": {
        "AMADEUS_CLIENT_ID": "your_client_id",
        "AMADEUS_CLIENT_SECRET": "your_client_secret",
        "AMADEUS_HOSTNAME": "production"
      }
    }
  }
}

用法

配置后，MCP服务器为Claude提供50多种工具。以下是一些示例提示：

航班搜索

Find me flights from New York to London departing on 2025-12-15

酒店搜索

Show me hotels in Paris for check-in on 2025-12-20 and check-out on 2025-12-23

活动

What are the top tourist attractions near the Eiffel Tower?

旅游见解

What are the most popular destinations from San Francisco this month?

航班状态

What's the status of flight AA100 on 2025-11-15?

可用工具

服务器提供50多种MCP工具，按类别组织：

飞行工具（12）

flight_offers_search -搜索航班优惠
flight_offers_pricing -确认定价
flight_create_order -预订航班
flight_order_get -获取预订详情
flight_order_delete -取消预订
flight_inspiration_search -寻找便宜的目的地
flight_cheapest_date_search -查找最便宜的日期
flight_availability_search -高级搜索
seatmap_display -查看座位图
branded_fares_upsell -获得票价升级
flight_choice_prediction -预测偏好
flight_status -实时状态

酒店工具（6）

hotel_offers_search -搜索酒店
hotel_offer_search -获取优惠详情
hotel_booking -预订酒店
hotel_list_by_city -按城市列出酒店
hotel_list_by_geocode -按地点列出酒店
hotel_sentiments -评审分析

活动工具（6）

points_of_interest_search -查找POI
points_of_interest_by_square -区域POI
point_of_interest_details -POI详细信息
activities_search -查找活动
activities_by_square -区域活动
activity_details -活动详情

转移工具（3）

transfer_search -搜索转账
transfer_booking -图书转让
transfer_cancellation -取消转账

参考数据工具（7）

location_search -搜索地点
airport_city_search -查找机场/城市
nearest_airport -查找最近的机场
airline_lookup -航空公司信息
checkin_links -检查URL
airport_routes -机场航线
airline_routes -航空公司航线

分析工具（4）

most_booked_destinations -热门目的地
most_traveled_destinations -旅游趋势
busiest_travel_period -高峰期
location_score -位置评级

预测工具（4）

flight_delay_prediction -延迟可能性
trip_purpose_prediction -商务vs休闲
airport_on_time_performance -准时统计数据
flight_price_analysis -价格指标

发展

构建

npm run build

观看模式

npm run watch

直接运行

npm run dev

测试

该项目包括所有50多个API终点的综合测试：

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Run tests with coverage report
npm run test:coverage

看测试_用户.md 获取详细的测试文档。

测试覆盖范围：

✅ 12航班API终点
✅ 6酒店API终点
✅ 6个活动和POI端点
✅ 3个传输端点
✅ 7参考数据端点
✅ 8分析和预测端点
✅ 完整预订流程的集成测试

API文档

有关API的详细文档，请访问：

测试与生产

Amadeus提供两种环境：

测试环境：使用测试证书进行示例数据开发
生产环境：使用制作凭证进行实际预订（收费）

集 AMADEUS_HOSTNAME=test 用于测试或 AMADEUS_HOSTNAME=production 实时数据。

局限性

某些API需要生产凭据
预订API可能会产生费用
根据您的Amadeus帐户级别适用费率限制
某些端点需要特定的数据格式（请参阅Amadeus文档）

安全说明

永远不要承诺你的 .env 文件或凭据
对敏感数据使用环境变量
对于生产使用，实施适当的凭据管理
查看Amadeus的服务条款和API使用政策

许可证

麻省理工学院

支持

贡献

欢迎投稿！请随时提交拉取请求。