✈️ 飞行MCP服务器
大规模的对话式旅行
一个模型上下文协议(MCP)服务器,支持实时智能的聊天首飞预订。问你的人工智能助理“下周纽约市?”,在几分钟内预订航班——没有标签,没有摩擦,只是旅行。
______________________________________________________________________
🎯 特性
✅ 会话航班搜索 -问自然语言问题,获得实时结果\ ✅ 多过滤器选项 -按价格、时间、持续时间、航空公司偏好搜索\ ✅ 实时谷歌航班数据 -实时定价和可用性\ ✅ 无缝MCP集成 -适用于Claude Desktop、Cursor和其他MCP客户端\ ✅ 单程和往返支持 -完全灵活的预订\ ✅ 智能意图检测 -自动了解旅行偏好\ ✅ 日历集成 -自动将行程注入日历
______________________________________________________________________
🏗️ 建筑
[ Chat UI ]
↓
[ MCP Client SDK ]
↓
[ MCP Gateway Server ]
├── Context Manager
├── Intent Engine (LLM + Rules)
├── Flight Search Tool
├── Booking Tool
├── Preference Engine
└── Trigger Engine核心组件
- 意图引擎 -解析自然语言旅行请求
- 航班搜索工具 -实时查询Google航班API
- 首选引擎 -了解用户偏好(航空公司、座位类型、预算)
- 上下文管理器 -保持对话状态
- 日历注射器 -将预订与日历应用程序同步
______________________________________________________________________
🚀 快速开始
先决条件
- Python 3.8+
uv(Python包管理器)- Claude Desktop、Cursor或其他兼容MCP的客户端
安装
1.克隆存储库
git clone https://github.com/smamidipaka6/flights-mcp-server.git
cd flights-mcp-server2.安装 uv
macOS/Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh窗户:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"⚠️ 安装后,重新启动终端 uv 命令被识别。
3.配置克劳德桌面
导航到您的Claude配置文件:
macOS:
code ~/Library/Application\ Support/Claude/claude_desktop_config.json窗户:
code $env:AppData\Claude\claude_desktop_config.json将此添加到您的 mcpServers 章节:
{
"mcpServers": {
"flights": {
"command": "/ABSOLUTE/PATH/.local/bin/uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/flights-mcp-server",
"run",
"flights.py"
]
}
}
}示例(macOS):
{
"mcpServers": {
"flights": {
"command": "/Users/yourname/.local/bin/uv",
"args": [
"--directory",
"/Users/yourname/flights-mcp-server",
"run",
"flights.py"
]
}
}
}找到你的 uv 路径:
- macOS/Linux:
which uv - 窗户:
where uv
4.重新启动克劳德桌面
关闭并重新打开Claude Desktop。您应该看到MCP工具图标出现。
______________________________________________________________________
🛠️ 可用工具
get_general_flights_info()
检索给定航线的综合航班信息。
参数:
origin(str)-始发机场IATA代码(例如“JFK”、“LAX”)destination(str)-目的地机场IATA代码(例如“LAS”、“ORD”)departure_date(str)-YYYY-MM-DD格式的出发日期trip_type(str,可选)-“单向”或“往返”(默认:“单向”)seat(str,可选)-“经济型”、“高级经济型”,“商务型”,”首选“(默认:“经济型)”adults(int,可选)-成年乘客人数(默认值:1)children(int,可选)-儿童乘客数量(默认值:0)infants_in_seat(int,可选)-需要座位的婴儿(默认值:0)infants_on_lap(int,可选)-婴儿坐在腿上(默认值:0)n_flights(int,可选)-返回的航班数(默认值:40)
例子:
"Find flights from New York (JFK) to Las Vegas (LAS) on December 15th"______________________________________________________________________
get_cheapest_flights()
按价格排序,找到最实惠的航班选项。
参数: 同 get_general_flights_info() 除了 n_flights
例子:
"Show me the cheapest flights from Los Angeles (LAX) to Miami (MIA) for January 10th"______________________________________________________________________
get_best_flights()
获取Google Flights的顶级推荐航班。
参数: 同 get_general_flights_info()
例子:
"What are the best flights from Chicago (ORD) to Denver (DEN) on November 25th?"______________________________________________________________________
get_time_filtered_flights()
按特定时间限制过滤航班。
参数:
origin(str)-始发机场代码destination(str)-目的地机场代码departure_date(str)-出发日期(YYYY-MM-DD)state(str)-“之前”或“之后”target_time_str(str)-HH:MM AM/PM格式的目标时间- 加上来自的所有可选参数
get_general_flights_info()
例子:
"Find flights from Seattle (SEA) to Las Vegas (LAS) on December 1st departing after 2:00 PM"______________________________________________________________________
💬 用法示例
简单的单向搜索
"Find me flights to Las Vegas from New York next week"带偏好的往返行程
"Book round-trip flights from San Francisco to Tokyo for 2 adults and 1 child,
departing January 15th, returning January 25th. I want business class."感恩节旅行
"Get flights from New York (JFK) to Las Vegas (LAS) for November 25-30
to catch Chris Tucker at the Encore Theater. Show me the best options."基于时间的过滤
"Find me flights from Denver to Miami on December 10th before 10:00 AM"预算意识搜索
"Show me the cheapest flights from Boston (BOS) to Orlando (MCO)
for 2 adults departing March 1st"______________________________________________________________________
🔄 支持的机场代码
美国常见机场:
- 约翰·F·肯尼迪 -纽约(拉瓜迪亚)
- 洛杉矶国际机场 -洛杉矶
- 奥黑尔国际机场(芝加哥国际机场) -芝加哥
- DFW -达拉斯-沃斯堡
- ATL -亚特兰大
- 登 -丹佛
- 旧金山国际机场 -旧金山
- 激光声表面波 -拉斯维加斯
- 失踪 -迈阿密
- BOS -波士顿
使用任何IATA机场代码(检查 skyscanner.com 或 flightradar24.com 代码)。
______________________________________________________________________
🎨 适用于不同的MCP客户端
克劳德桌面
请参阅上面的安装说明。 ✅
光标
- 打开光标设置
- 首选 主控程序 标签
- 创建
.cursor/mcp.json在您的项目或~/.cursor/mcp.json全球范围内 - 添加此配置:
{
"mcpServers": {
"flights": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/flights-mcp-server",
"run",
"flights.py"
]
}
}
}其他MCP客户端
请参阅客户的MCP文档,并遵循相同的配置模式。
______________________________________________________________________
🔌 API 参考
响应格式
所有工具返回结构化飞行数据:
{
"flights": [
{
"airline": "United Airlines",
"departure_time": "10:30 AM",
"arrival_time": "1:45 PM",
"duration": "5h 15m",
"stops": 1,
"price": "$245",
"route": "JFK → LAS"
}
],
"total_results": 40,
"search_params": {
"origin": "JFK",
"destination": "LAS",
"departure_date": "2025-11-25"
}
}______________________________________________________________________
🚀 用例
商务旅行
“给我订下周一早上从纽约到旧金山的航班,周五晚上回来。我需要商务舱。”
假期规划
“寻找圣诞节周从芝加哥到奥兰多的家庭航班。我需要2名成人和2名儿童的座位。”
自助旅行
“给我看看周末从洛杉矶到丹佛最便宜的航班。”
基于事件的旅行
“给我安排感恩节去拉斯维加斯看喜剧表演的航班。11月25日出发,11月30日返回。”
______________________________________________________________________
📋 当前限制
- ⚠️ 只有一条路 -目前处理单程航班(往返航班按两次单程搜索处理)
- 🔄 往返和多城市预订即将到来
- 💳 发展中的支付一体化
______________________________________________________________________
🤝 贡献
我们很乐意得到你的帮助!以下是如何做出贡献:
- 分叉 存储库
- 创建要素分支 (
git checkout -b feature/amazing-feature) - 提交您的更改 (
git commit -m 'Add amazing feature') - 推到分支 (
git push origin feature/amazing-feature) - 打开拉取请求
功能请求
- 往返航班支持
- 多城市预订
- 支付集成
- 座位选择界面
- 日历同步自动化
______________________________________________________________________
📦 依赖项
python-dotenv-环境变量管理requests-用于Google航班的HTTP客户端APImcp-模型上下文协议SDK
______________________________________________________________________
🔐 安全与隐私
- 我们的服务器上没有存储任何个人数据
- 所有航班搜索都是对谷歌航班的实时查询
- MCP通信是端到端加密的
- 完全透明的开源
______________________________________________________________________
📝 许可证
该项目根据MIT许可证获得许可。看 许可证 了解详情。
______________________________________________________________________
🙋 支持
有问题吗?
______________________________________________________________________
🎬 演示
观察飞行MCP服务器的运行情况:
User: "Get me flights from New York to Las Vegas for Thanksgiving week"
Claude Desktop:
✓ Intent detected: Travel to Las Vegas, Nov 25-30
✓ Searching flights: JFK → LAS
✓ Found 40+ options
✓ Top 3 results:
1. United $245 - 5h 15m (1 stop)
2. Delta $289 - 4h 50m (Direct) ← Recommended
3. Southwest $212 - 6h 10m (2 stops)
Book? Yes → Calendar invite sent ✓______________________________________________________________________
🚀 路线图
- \[x\] 基本航班搜索
- \[x\] 价格过滤
- \[x\] 基于时间的过滤
- \[\]往返预订
- \[\]多城市行程
- \[\]集成支付处理
- \[\]座位选择界面
- \[\]酒店+航班套餐
- \[\]忠诚度计划集成
- \[\]移动应用支持
______________________________________________________________________
💚 用爱建造
Flight MCP Server旨在使旅行计划无障碍。
今天就开始对话式预订航班吧! ✈️
______________________________________________________________________
⭐ 表示支持
如果你觉得这个项目有帮助,请给它一个 星 在GitHub上!它帮助其他人发现项目。
git star smamidipaka6/flights-mcp-server______________________________________________________________________
由以下材料制成❤️ 通过 马米迪帕卡先生
让我们让预订变得顺畅。一起。
