本站所有内容均由自动化程序抓取自第三方网站,部分内容未及时审核,如有侵权,违规,请联系我们第一时间删除!QQ:3963907323
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