旅行数据服务

旅行MCP服务器（Amadeus API）

一 MCP（模型上下文协议） 服务器 Amadeus旅行API，直接向提供航班、酒店、机场和旅游数据 克劳德桌面 或任何MCP兼容客户端。

特性

• 飞行服务：搜索航班、获取最便宜的日期、航班灵感、定价、可用性、分析（18个工具）
• 酒店服务：搜索酒店，获取详细信息，评级，预订，自动完成（7个工具）
• 机场和航空公司数据：机场搜索、航空公司查找、路线、准点率（7个工具）
• 旅行服务：接送、旅游和活动、兴趣点、旅行推荐（11个工具）
• 高级分析：航班延误预测、价格分析、行程目的预测
• 实时数据：航班状态、座位图、旅行限制
• 总共43个工具 具有全面的缓存和速率限制

快速开始

先决条件

• Node.js 18+或更高版本
• pnpm（推荐）或npm
• Amadeus API证书（免费 developers.amadeus.com)

安装

git clone https://github.com/CVamsi27/travel-mcp-server
cd travel-mcp-server
pnpm install

配置

1. 获取Amadeus API证书 （免费测试环境）：

   • 注册地址： Amadeus开发者版
   • 创建新应用程序→ 选择“测试环境”
   • 复制您的API密钥和秘密

2. 创建环境文件:

# .env file
AMADEUS_CLIENT_ID=your_test_api_key_here
AMADEUS_CLIENT_SECRET=your_test_api_secret_here
AMADEUS_HOSTNAME=test
CACHE_TTL_MINUTES=5
RATE_LIMIT_REQUESTS=5
MAX_RETRIES=3

3. 测试您的设置:

pnpm test
# Should show: ✓ Connection successful!

Claude桌面集成

设置Claude桌面配置

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

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

{
  "mcpServers": {
    "travel-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/travel-mcp-server/index.js"],
      "env": {
        "AMADEUS_CLIENT_ID": "your_test_api_key_here",
        "AMADEUS_CLIENT_SECRET": "your_test_api_secret_here",
        "AMADEUS_HOSTNAME": "test"
      }
    }
  }
}

替换 /absolute/path/to/travel-mcp-server/ 使用您的实际安装路径。

重新启动克劳德桌面

更新配置后，完全重新启动Claude Desktop以使更改生效。

Claude使用示例

配置后，您可以使用自然语言搜索航班和酒店：

航班搜索示例

基本航班搜索：

Find flights from New York to Los Angeles on September 15th, 2025

多人往返：

Search for round-trip flights from London to Paris, departing September 20th and returning September 27th for 2 adults

查找最便宜的日期：

What are the cheapest dates to fly from JFK to LAX?

飞行灵感：

Show me destination inspiration from New York (JFK)

飞行分析：

Get flight price analysis for JFK to LAX on September 15th, 2025

酒店搜索示例

城市酒店搜索：

Find hotels in Paris for check-in September 15th and check-out September 18th for 2 adults

基于位置的搜索：

Search for hotels near Times Square (latitude 40.7589, longitude -73.9851)

酒店详情：

Get details for hotel HLPAR123 for September 15-18, 2025

机场和航空公司示例

机场搜索：

Find airports near London

最近的机场：

What are the nearest airports to coordinates 51.4700, -0.4543?

航空公司信息：

Look up information for airline codes AA, UA, and BA

机场性能：

Get on-time performance data for LHR airport

旅游服务示例

地面转移：

Find private transfers from CDG airport to Paris on September 15th at 10:00 AM

旅游和活动：

Search for tours and activities near the Eiffel Tower (48.8566, 2.3522)

兴趣点：

Find restaurants and sights near Times Square within 2km

旅行限制：

What are the travel restrictions from US to France?

可用工具（共43个）

飞行工具（18）

• searchFlights -在不同地点之间搜索航班优惠
• getCheapestFlightDate -查找最便宜的旅行日期
• getFlightInspiration -获得目的地灵感
• getFlightOffersPrice -价格特定的航班优惠
• searchFlightAvailabilities -检查航班可用性
• getFlightBusiestPeriod -机场交通分析
• getFlightMostBookedDestinations -热门目的地
• getFlightMostTraveledDestinations -出行模式分析
• getFlightPriceAnalysis -价格趋势分析
• getFlightChoicePrediction -基于机器学习的选择预测
• getFlightDelayPrediction -延迟概率分析
• getFlightStatus -实时航班状态
• getFlightCheckinLinks -航空公司值机URL
• getSeatMap -飞机座位图
• createFlightOrder -预订航班（制作）
• getFlightOrder -检索预订
• deleteFlightOrder -取消预订
• getBrandedFares -高级票价选项

酒店工具（7）

• searchHotelsByCity -按城市代码搜索酒店
• getHotelDetails -详细的酒店信息和优惠
• searchHotelsByLocation -基于位置的酒店搜索
• searchHotels -使用过滤器进行一般酒店搜索
• getHotelList -带连锁/便利设施过滤器的酒店列表
• getHotelNameAutocomplete -酒店名称建议
• getHotelRatings -酒店情绪分析和评级

机场和航空公司工具（7）

• searchAirportsAndCities -机场和城市搜索
• getNearestRelevantAirports -查找附近的机场
• getAirportOnTimePerformance -机场绩效指标
• getAirportRoutes -机场服务的目的地
• lookupAirlineCode -航空公司信息查询
• getAirlineRoutes -航线网络
• searchCities -使用国家过滤器进行城市搜索

旅游服务工具（11）

• searchTransfers -地面接送搜索（出租车、私人等）
• searchToursAndActivities -当地活动和旅游
• getActivityDetails -详细活动信息
• getPointsOfInterest -POI发现（餐厅、景点等）
• getPointOfInterestDetails -详细POI信息
• getLocationScore -位置质量评分
• getTravelRecommendations -基于人工智能的目的地建议
• getTravelRestrictions -当前差旅需求
• parseTripData -解析旅行证件
• predictTripPurpose -出行目的分析（商务/休闲）

高级功能

飞行分析和预测

Predict delays for flight AA100 from JFK to LAX on September 15th

酒店情绪分析

Get ratings and reviews sentiment for hotels HLPAR123,HLPAR456

位置智能

Get location score for coordinates 48.8566, 2.3522 (Eiffel Tower area)

旅行目的预测

Predict if a NYC to LAX trip departing December 15th returning December 18th is business or leisure

错误处理和速率限制

服务器包括全面的错误处理：

• 自动重试 指数回退
• 速率限制 具有可配置的限制
• 响应缓存 以减少API调用
• 输入验证 对于所有参数
• 详细的错误消息 用于调试

测试环境限制

• 每月有限的API调用
• 某些端点可能受到限制
• 速率限制适用于每个端点

生产环境

• 可用更高的限制
• API完全访问
• 按使用付费定价

故障排除

常见问题

1. “找不到工具”错误

   • 配置更改后重新启动Claude Desktop
   • 验证claude_desktop_config.json中的绝对路径

2. “缺少API凭据”

   • 检查.env文件或环境变量
   • 在Amadeus开发人员仪表板上验证凭据

3. “日期/时间已过”

   • 始终使用未来日期（明天或更晚）
   • 格式：YYYY-MM-DD

4. “IATA代码无效”

   • 使用3个字母的机场代码（JFK、LAX、LHR）
   • 使用城市代码（NYC、LON、标准杆数）进行基于城市的搜索

5. API费率限制

   • 测试环境的调用次数有限
   • 检查Amadeus仪表板的使用情况
   • 在请求之间等待或升级到生产环境

启用调试日志记录

AMADEUS_LOG_LEVEL=debug

测试连接

node diagnostic.js

生产部署

准备生产时：

1. 升级至生产API:

   复制

   AMADEUS_HOSTNAME=production
   AMADEUS_CLIENT_ID=your_production_key
   AMADEUS_CLIENT_SECRET=your_production_secret
   

2. 提高速率限制:

   复制

   RATE_LIMIT_REQUESTS=50
   CACHE_TTL_MINUTES=15
   

3. 启用预订功能:

   • 航班订单和取消
   • 酒店预订（如有）
   • 接送预订

API文档

有关API的详细信息：

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

支持

• GitHub问题: 报告错误或请求功能
• Amadeus支持: API文件和限制
• 克劳德桌面: MCP集成指南

许可证

这个项目是开源的，可以在MIT许可证下使用。