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 为开发者提供了快速、安全、易扩展的火车票查询解决方案，适配大模型、自动化脚本与企业系统等多元场景。
GitHub：https://github.com/drfccv/mcp-server-12306