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