Flight Ticket MCP Server

一个基于模型上下文协议(MCP)的航空机票查询服务器。该服务器为AI助手提供标准化的航班实时动态查询功能接口。

概述

Flight Ticket MCP Server 实现了供航空机票相关查询操作的工具和资源。它作为AI助手与航空服务系统之间的桥梁，专注于航班实时动态查询功能。

该服务器采用模块化架构，将核心功能、工具和实用程序分离，使其具有高度的可维护性和可扩展性。

功能特性

航班路线查询

根据出发地、目的地和出发日期查询可用航班
支持282个国内城市和机场代码
智能城市名称解析（支持城市名、机场代码、完整格式）
实时航班价格和航班时刻信息
航空公司和机型信息
航站楼和登机口信息
价格统计和航空公司分布
格式化输出结果

航班中转路线查询

根据出发地、中转地、目的地查询联程航班
支持自定义最小和最大中转时间（默认2-5小时）
智能筛选符合中转时间要求的航班组合
提供完整的两段航程信息
支持国内外航线中转查询
详细的中转时间计算和验证

天气信息查询

按经纬度查询：精确地理位置天气查询
按城市名查询：支持主要城市直接查询
使用Open-Meteo免费天气API
支持历史、当前和未来天气数据
提供温度、湿度、风速、天气状况等详细信息
自动处理时区和日期范围
支持武汉、北京、上海等主要城市预设

日期时间工具

获取当前系统日期（YYYY-MM-DD格式）
获取当前系统日期时间（YYYY-MM-DD HH格式）
为其他功能提供标准化的日期时间支持
自动处理时区和格式转换

数据处理与智能化

智能城市解析：支持多种城市输入格式（城市名、机场代码、完整格式）
参数验证：全面的输入参数验证和错误处理
结果格式化：统一的JSON格式输出，便于AI助手解析
错误恢复：完善的异常处理和降级机制
日志记录：详细的操作日志和调试信息

技术架构

核心模块 (Core)

航班数据模型和结构定义
机场、航空公司、航班、价格等数据模型
航班中转和座位配置数据结构

工具模块 (Tools)

航班搜索工具 (flight_search_tools.py) - 航班路线查询功能
航班中转工具 (flight_transfer_tools.py) - 多段航程和中转查询
天气查询工具 (weather_tools.py) - 基于经纬度和城市的天气查询
日期时间工具 (date_tools.py) - 日期时间获取和处理

实用工具 (Utils)

城市字典 (cities_dict.py) - 282个城市和机场代码映射
数据验证器 (validators.py) - 输入参数验证和格式检查
日期工具 (date_utils.py) - 日期格式化和时区处理
API客户端 (api_client.py) - HTTP请求封装和错误处理

MCP集成层

FastMCP服务器 - 基于FastMCP框架的MCP协议实现
多传输协议支持 - stdio、SSE、HTTP传输协议
工具注册管理 - 统一的工具注册和调用机制
环境配置管理 - 灵活的配置和环境变量支持

支持的传输协议

本服务器支持三种传输协议：

sse - Server-Sent Events（默认，适用于Web应用）
stdio - 标准输入输出（适用于Claude Desktop）
streamable-http - 可流式HTTP（适用于HTTP客户端）

安装

前置要求

Python 3.11 或更高版本
pip 包管理器

基本安装

# 克隆或下载项目
cd FlightTicketMCPServer

# 安装依赖
pip install -r requirements.txt

启动方式

1. 直接启动（默认SSE模式）

# 使用主启动文件（默认启动SSE模式，监听127.0.0.1:8000）
python flight_ticket_server.py

# 或者直接运行main.py
python main.py

2. 调试模式启动

# 启用调试模式，会输出详细日志
set MCP_DEBUG=true
python flight_ticket_server.py

# Linux/macOS
export MCP_DEBUG=true
python flight_ticket_server.py

3. 不同传输协议启动

SSE模式（默认）

# 直接启动，使用默认SSE配置（127.0.0.1:8000）
python flight_ticket_server.py

stdio模式

# Windows
set MCP_TRANSPORT=stdio
python flight_ticket_server.py

# Linux/macOS
export MCP_TRANSPORT=stdio
python flight_ticket_server.py

HTTP模式

# Windows
set MCP_TRANSPORT=streamable-http
set MCP_HOST=127.0.0.1
set MCP_PORT=8000
python flight_ticket_server.py

# Linux/macOS
export MCP_TRANSPORT=streamable-http
export MCP_HOST=127.0.0.1
export MCP_PORT=8000
python flight_ticket_server.py

4. 环境变量配置

使用 .env 文件（推荐）

项目提供了 .env.example 文件作为配置模板：

复制配置模板：
# 复制配置模板 cp .env.example .env
编辑配置文件：打开 .env 文件，根据需要修改配置值：
# MCP服务器配置 MCP_TRANSPORT=sse MCP_HOST=127.0.0.1 MCP_PORT=8000 MCP_SSE_PATH=/sse # 日志配置 LOG_LEVEL=INFO LOG_FILE_PATH=logs/flight_server.log LOG_MAX_SIZE=10 LOG_BACKUP_COUNT=5 # 开发配置 MCP_DEBUG=false
配置说明：
- .env 文件包含敏感配置，不会被提交到版本控制
- .env.example 是安全的模板文件，可以提交到Git
- 环境变量优先级：系统环境变量 > .env文件 > 程序默认值

直接设置环境变量

如果不使用 .env 文件，也可以直接设置环境变量：

支持的环境变量：

变量名	描述	默认值	可选值
`MCP_TRANSPORT`	传输协议类型	`sse`	`stdio`, `sse`, `streamable-http`
`MCP_HOST`	服务器主机地址	`127.0.0.1`	任何有效IP地址
`MCP_PORT`	服务器端口	`8000`	1-65535
`MCP_PATH`	HTTP路径	`/mcp`	任何有效路径
`MCP_SSE_PATH`	SSE路径	`/sse`	任何有效路径
`MCP_DEBUG`	调试模式	`false`	`true`, `false`, `1`, `0`
`LOG_LEVEL`	日志级别	`INFO`	`DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`
`LOG_FILE_PATH`	日志文件路径	`logs/flight_server.log`	任何有效路径
`LOG_MAX_SIZE`	日志文件最大大小(MB)	`10`	正整数
`LOG_BACKUP_COUNT`	日志备份数量	`5`	正整数
`FASTMCP_LOG_LEVEL`	FastMCP日志级别	`INFO`	`DEBUG`, `INFO`, `WARNING`, `ERROR`

5. 启动验证

启动成功后，您会看到类似输出：

Transport: sse
Logging enabled - logs will be saved to logs/ directory
Flight Ticket MCP Server starting...
Transport: sse
All tools registered successfully
Starting SSE transport on 127.0.0.1:8000/sse

6. 日志文件

服务器启动后会在 logs/ 目录下生成以下日志文件：

flight_server.log - 一般日志（INFO级别及以上）
flight_server_error.log - 错误日志（ERROR级别）
flight_server_debug.log - 调试日志（仅在调试模式下生成）

7. 停止服务器

stdio模式: 按 Ctrl+C 停止
HTTP/SSE模式: 按 Ctrl+C 或发送SIGTERM信号

使用方法

与Claude Desktop配置

安装完成后，将服务器添加到Claude Desktop配置文件中：

{
  "mcpServers": {
    "flight-ticket-server": {
      "command": "python",
      "args": ["D:\\FlightTicketMCPServer\\flight_ticket_server.py"],
      "env": {
        "MCP_TRANSPORT": "sse",
        "MCP_HOST": "127.0.0.1",
        "MCP_PORT": "8000"
      }
    }
  }
}

配置文件位置：
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
重启Claude Desktop以加载配置。

不同传输协议的配置

SSE模式（默认）

{
  "mcpServers": {
    "flight-ticket-server": {
      "command": "python",
      "args": ["D:\\FlightTicketMCPServer\\flight_ticket_server.py"],
      "env": {
        "MCP_TRANSPORT": "sse",
        "MCP_HOST": "127.0.0.1",
        "MCP_PORT": "8000",
        "MCP_SSE_PATH": "/sse"
      }
    }
  }
}

stdio模式

{
  "mcpServers": {
    "flight-ticket-server": {
      "command": "python",
      "args": ["D:\\FlightTicketMCPServer\\flight_ticket_server.py"],
      "env": {
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

HTTP模式

{
  "mcpServers": {
    "flight-ticket-server": {
      "command": "python",
      "args": ["D:\\FlightTicketMCPServer\\flight_ticket_server.py"],
      "env": {
        "MCP_TRANSPORT": "streamable-http",
        "MCP_HOST": "127.0.0.1",
        "MCP_PORT": "8000",
        "MCP_PATH": "/mcp"
      }
    }
  }
}

示例操作

配置完成后，您可以要求Claude执行以下操作：

航班路线查询

"查询重庆到广州明天的航班"
"搜索上海到北京后天的所有航班"
"查看深圳飞成都2024年7月20日的航班价格"
"北京到三亚的航班有哪些选择"
"帮我找一下成都到杭州下周二的航班信息"

航班中转查询

"查询北京经香港到纽约的中转航班"
"搜索上海经迪拜到伦敦的联程航班，中转时间3-6小时"
"查找广州经新加坡到悉尼的航班，最短中转2小时"
"北京到洛杉矶，经东京中转的航班有哪些"

天气信息查询

"查询北京今天和明天的天气情况"
"上海的天气怎么样"
"查询纬度39.9042，经度116.4074的天气"（北京坐标）
"武汉本周的天气预报"
"查询重庆2024年7月15日到7月17日的天气"

日期时间查询

"今天是几号"
"现在的日期和时间是什么"
"帮我获取当前日期"

综合查询示例

"我要从成都飞北京，明天出发，顺便告诉我北京的天气"
"查询上海到广州的航班，还有广州的天气情况"
"帮我规划从重庆到东京的行程，需要中转，并查看目的地天气"

API参考

航班路线查询

searchFlightRoutes(departure_city, destination_city, departure_date)  # 根据出发地、目的地和日期查询可用航班

输入参数：

departure_city: 出发城市名称或机场代码 (如: "重庆", "CKG", "重庆(CKG)")
destination_city: 目的地城市名称或机场代码 (如: "广州", "CAN", "广州(CAN)")
departure_date: 出发日期 (YYYY-MM-DD格式)

输出信息：

航班列表（包含航班号、航空公司、起飞到达时间、机场、航站楼、价格）
价格统计（最低价、最高价、平均价）
航空公司分布统计
格式化的查询结果输出
支持的城市：282个国内城市和机场

支持的城市格式：

城市名：上海、北京、重庆、广州等
机场代码：SHA、BJS、CKG、CAN等
完整格式：上海(SHA)、北京(BJS)等

航班中转路线查询

getTransferFlightsByThreePlace(from_place, transfer_place, to_place, min_transfer_time, max_transfer_time)

输入参数：

from_place: 出发地城市名称或机场代码 (如: "北京", "BJS")
transfer_place: 中转地城市名称或机场代码 (如: "香港", "HKG")
to_place: 目的地城市名称或机场代码 (如: "纽约", "NYC")
min_transfer_time: 最小中转时间（小时），默认2.0小时
max_transfer_time: 最大中转时间（小时），默认5.0小时

输出信息：

符合条件的中转航班组合列表
第一段航程详细信息（出发地到中转地）
第二段航程详细信息（中转地到目的地）
实际中转时间计算
航班号、时间、机场等详细信息

天气信息查询

按经纬度查询

getWeatherByLocation(latitude, longitude, start_date, end_date)

输入参数：

latitude: 纬度 (如: 39.9042)
longitude: 经度 (如: 116.4074)
start_date: 开始日期 (YYYY-MM-DD格式)，可选
end_date: 结束日期 (YYYY-MM-DD格式)，可选

按城市名查询

getWeatherByCity(city_name, start_date, end_date)

输入参数：

city_name: 城市名称 (如: "北京", "上海", "武汉")
start_date: 开始日期 (YYYY-MM-DD格式)，可选
end_date: 结束日期 (YYYY-MM-DD格式)，可选

输出信息：

天气状况描述
温度信息（最高温、最低温、当前温度）
湿度、风速、风向
降水概率和降水量
日出日落时间
紫外线指数

日期时间工具

getCurrentDate()  # 获取当前日期（YYYY-MM-DD格式）

输出信息：

当前系统日期字符串

开发

项目结构

FlightTicketMCPServer/
├── flight_ticket_server/
│   ├── core/              # 核心业务逻辑
│   ├── tools/             # MCP工具实现
│   ├── utils/             # 实用工具函数
│   └── main.py            # 服务器入口点
├── office_flight_ticket_server/  # 额外模块
├── tests/                 # 测试文件
├── logs/                  # 日志文件目录
├── pyproject.toml         # 项目配置
├── requirements.txt       # 项目依赖
├── flight_ticket_server.py # 主启动文件
├── mcp-config.json        # MCP配置示例
└── README.md              # 项目文档

测试

# 运行所有测试
python -m pytest tests/ -v

# 运行基本功能测试
python -m pytest tests/test_basic.py -v

# 运行特定测试
python -m pytest tests/test_basic.py::TestFlightSearch::test_searchFlightsByNumber -v

日志和调试

日志文件位置：logs/ 目录
启用调试模式：设置 MCP_DEBUG=true
查看实时日志：tail -f logs/flight_server.log

故障排除

常见问题

端口被占用
# 更改端口 set MCP_PORT=8001 python flight_ticket_server.py
导入错误
# 确保在正确的目录 cd FlightTicketMCPServer/flight_ticket_server python flight_ticket_server.py
权限问题
# 检查文件权限 ls -la flight_ticket_server.py chmod +x flight_ticket_server.py

日志分析

查看日志文件了解详细错误信息：

# 查看一般日志
cat logs/flight_server.log

# 查看错误日志
cat logs/flight_server_error.log

# 实时监控日志
tail -f logs/flight_server.log

许可证

MIT License - 查看 LICENSE 文件获取详细信息。

贡献

欢迎提交Issue和Pull Request来改进这个项目。

支持

如果您遇到问题或有功能建议，请在GitHub上创建Issue。

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A server that provides real-time flight information query capabilities to AI assistants, allowing them to access detailed flight statuses, airport details, and related travel information.

Related MCP Servers

MCP Live Events Server
mmmaaatttttt
A
security
F
license
A
quality
This server integrates with the Ticketmaster API to provide AI agents with real-time concert and event data, enabling dynamic fetching and formatting for ease of interpretation.
Last updated -
1
2
Python
Variflight Tripmatch MCP Serverofficial
variflight
A
security
F
license
A
quality
Provides tools to query flight and train information including flight searches, train tickets, weather forecasts, and transfer options between different transportation modes.
Last updated -
9
9
Flight MCP Server
sragss
-
security
F
license
-
quality
A real-time flight tracking interface for LLMs that connects AI assistants to live aircraft data from ADS-B Exchange, enabling searches by location, specific flight tracking, military aircraft monitoring, and aviation pattern discovery.
Last updated -
1
JavaScript
Polarsteps MCP Server
remuzel
-
security
A
license
-
quality
A server that enables AI assistants to access Polarsteps travel data, allowing queries about user profiles, trip details, travel statistics, and natural language search through travel histories.
Last updated -
2
Python
MIT License

View all related MCP servers

Appeared in Searches

A planner for grouping travel activities by location and creating daily itineraries