在智能助手、自动化订票和企业出行系统中,获取准确、实时的火车票信息是一项关键需求。12306 MCP Server 是一款开源、高性能后端服务,通过标准化 MCP 接口提供余票、车次、座席、经停站和换乘方案等功能。采用 FastAPI 异步框架和 Streamable HTTP 传输,实现秒级响应,并可快速集成至 AI 助手、自动化脚本及旅游 App。
12306 MCP Server 是什么?
12306 MCP Server 是一个开源火车票查询后端,兼容官方 12306 系统数据接口,同时支持 MCP 2025-03-26 标准。项目通过 FastAPI 提供异步处理能力,Streamable HTTP 流式返回结果,面向 AI 自动化和智能应用场景,帮助开发者快速构建高性能、可扩展的火车票服务。
开源地址:https://github.com/drfccv/mcp-server-12306

核心功能
12306 MCP Server 提供实用、高效的火车票数据服务:
- 余票 / 车次 /座席 /时刻查询——同步官方实时数据,确保查询准确性。
- 全国车站库与模糊搜索——拼写不准确也能准确定位车站,方便用户快速选择。
- 官方经停站与一次中转方案——支持灵活行程规划,自动推荐最佳换乘路线。
- 智能时间解析——支持“明早”“后天”等相对日期,避免手动输入错误。
- Streamable HTTP 传输——流式返回车票信息,提升交互体验与实时性。
- FastAPI 异步框架——秒级响应,低延迟,处理高并发请求。
- MCP 标准接口——AI/自动化场景开箱即用,无需解析复杂网页。
使用场景
12306 MCP Server 可服务多类应用和用户场景:
人群/角色 | 场景描述 | 推荐指数 |
---|---|---|
智能助手开发者 | 调用余票、经停和换乘数据,实现智能问答和提醒 | ★★★★★ |
自动订票脚本用户 | 自动化订票或日期提醒,减少人工操作错误 | ★★★★★ |
企业出行平台 | 旅游 App 或企业内部出行模块整合实时车票数据 | ★★★★☆ |
媒体或数据分析者 | 快速获取官方票务信息,用于报道或研究分析 | ★★★★☆ |
操作指南
快速部署 12306 MCP Server:
本地环境部署:
- 安装 Python 3.10+,推荐使用
uv
提升依赖安装速度。 - 克隆项目:
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 部署:
- 拉取官方镜像:
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 指南。
支持平台
- 本地 Python 环境——高并发异步处理,适合开发和生产环境。
- Docker 容器——一键部署,端口映射灵活,适合多种操作系统。
- HTTP 标准接口——兼容所有 MCP 客户端与工具,可嵌入 AI 自动化脚本。
产品定价
12306 MCP Server 开源免费,可自由使用、部署与二次开发。
常见问题
Q1:是否需要官方账户或凭证?
A1:无需登录或提供官方凭证,即可获取实时余票和车次信息。
Q2:能否支持高并发查询?
A2:采用 FastAPI 异步框架和 Streamable HTTP,支持秒级响应与多请求并发。
Q3:如何集成到智能助手或自动化脚本?
A3:通过 MCP 标准化接口直接调用,无需解析网页,可快速嵌入 Python、Node.js 等环境。
跳跳兔小结
12306 MCP Server 将实时火车票查询、换乘方案、车站信息与智能时间解析整合在高性能异步后端中,为 AI 助手、自动化脚本和企业系统提供即插即用方案。它适合需要高并发、实时性和标准化接口的开发者和企业用户,不适合完全依赖人工查询或单机静态票务管理的场景。开源和 Docker 部署确保灵活、安全、高效的数据接入。