AI赋能火车票查询:12306 MCP Server高效对接
12306 MCP Server是一款开源、高性能的火车票查询后端,提供实时余票查询、车站信息等功能,支持AI自动化集成,助力各类应用场景。
12306 MCP Server概览
核心定位
12306 MCP Server是一款开源、高性能的火车票查询后端,代码托管在GitHub,适用于AI自动化和智能助手等场景。它提供与官方12306系统相同的实时余票查询、车站信息、列车经停站和换乘方案等核心功能,并内置智能时间工具,避免手动输入日期带来的错误。系统采用FastAPI框架实现异步并发处理,保证秒级响应。通过标准化HTTP传输协议,支持MCP 2025-03-26版,开箱即用即可快速对接各种自动化脚本或智能产品,兼容所有符合MCP的客户端和工具。
适用场景
- 智能助理与聊天机器人直接调用余票、经停、换乘等数据
- 自动订票脚本或日期提醒工具
- 企业出行平台、旅游App的火车票模块
- 媒体将MCP描述为“将AI与应用粘合在一起”的关键协议,正在快速被开发者社区采纳。
功能亮点
| 功能 | 价值 |
|---|---|
| 余票 / 车次 / 座席 / 时刻一站式查询 | 精准同步12306实时数据 |
| 全国车站库与模糊搜索 | 拼写不准确也能定位车站 |
| 官方经停站与一次中转方案 | 行程规划更灵活 |
| 智能时间解析 | 支持“明早”之类相对日期,避免误选 |
| Streamable HTTP传输 | 支持SSE流式返回,提高交互体验 |
| FastAPI异步框架 | 秒级响应,低延迟 |
| MCP标准接口 | AI/自动化场景开箱即用 |
快速部署
本地环境
- Python 3.10+
- uv:速度可比pip提升10–100倍,安装依赖更快
git clone https://github.com/drfccv/12306-mcp-server.git cd 12306-mcp-server uv sync # 安装依赖 uv run python scripts/update_stations.py # 更新车站库 uv run python scripts/start_server.py # 启动服务 Docker部署
官方镜像已发布,可一键拉取并映射8000端口:

docker pull drfccv/12306-mcp-server:latest docker run -d -p 8000:8000 --name 12306-mcp-server drfccv/12306-mcp-server:latest 如需自定义构建,可在本地修改后执行docker build。更多容器化实践可参考FastAPI官方Docker指南。
技术栈与性能优势
- FastAPI + Uvicorn:在TechEmpower基准测试中位列最快Python框架之列。
- Streamable HTTP:支持长连接与流式事件推送,适合实时刷新车票信息。
- MCP Schema:标准化请求/响应格式,让大模型免去解析复杂HTML或按钮的麻烦。
12306 MCP Server项目地址
通过标准化MCP接口、高性能异步架构与即用型Docker镜像,12306 MCP Server为开发者提供了快速、安全、易扩展的火车票查询解决方案,适配大模型、自动化脚本与企业系统等多元场景。