
Mcp Server 12306
io.github.drfccv由 GitHub 帳號 drfccv 發布v0.3.1更新於 Oct 24, 2026
An MCP server that provides 12306 ticket query
概覽
提供 12306 火車票查詢的 MCP 伺服器,讓助理查詢剩餘車票、票價、車站、轉乘與時刻資訊。
- 可以做什麼
- 依路線與日期查詢剩餘車票、車次、座席與發車時刻
- 即時查詢各車次各席別票價
- 以中文、拼音、簡拼或三字碼模糊搜尋全國車站
- 查詢官方轉乘方案,以及指定列車的全部停靠站與到開時刻
- 將車次號轉為官方唯一編號,並取得目前時間或相對日期以協助選擇出行日期
- 適用情境
- 適合在中國規劃鐵路行程時使用,讓助理直接查看剩餘車票、票價、車站名稱、轉乘方案或停靠站,不必開啟 12306 網站或應用程式。
- 執行需求
- 以本機 Python 套件形式執行(Python 3.10 至 3.14 以下),可透過 uvx、pip 或 pipx 安裝,也可使用 Docker 映像。需要能連線 12306 官方介面的網路。SERVER_HOST、SERVER_PORT、DEBUG、LOG_LEVEL 等環境變數僅適用於 HTTP 模式。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Mcp Server 12306,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
🚄 MCP Server 12306
基于 Model Context Protocol (MCP) 的 12306 火车票查询服务
[PyPI - Version] [PyPI - Downloads] [Python - 3.10+] [Docker - Pulls] [License - MIT] [MCP - SDK v2] [Transport - Stdio/HTTP] [GitHub - Stars]
支持 余票 / 票价 / 车站 / 经停 / 换乘 / 时间 六大查询能力,开箱即用,适配 AI 助手、自动化脚本、智能终端等场景。
📑 目录
✨ 功能特性
🚀 快速开始
环境要求
💡 推荐使用
uv:环境隔离、安装快、锁文件管理依赖版本。
方式一:Stdio 模式(本地客户端推荐)
MCP Server 通过标准输入/输出与客户端通信,不占用网络端口,适合 Claude Desktop、Cursor 等本地 MCP 客户端。
安装:
客户端配置(如 claude_desktop_config.json):
其他安装方式(点击展开)
pipx:
本地源码(开发者调试):
方式二:Streamable HTTP 模式(远程部署)
Server 启动 Web 服务(默认
8000端口),通过 MCP Streamable HTTP 协议通信:POST发送 JSON-RPC、GET订阅流式响应、DELETE结束会话。
启动:
客户端配置:
内置 HTTP 端点:
方式三:Docker 部署
🛠️ 工具一览
📖 每个工具的参数说明、返回示例、调用示例详见 📚 详细文档。
⚙️ 配置项
通过环境变量或项目根目录 .env 文件配置:
🏗️ 项目结构
🧑💻 开发指南
架构要点:
server.py是传输无关的核心模块——工具注册(TOOL_HANDLERS)与业务分发(call_tool)都在此,stdio 与 HTTP 复用同一实例,保证两种模式行为完全一致。- 工具 Schema 单一来源于
ticket_service.MCP_TOOLS,HTTP 的/schema/tools端点与 MCP 工具列表同源。 - 网络请求统一走
_request_with_retry(自动重试 + init 会话保持),业务错误与网络错误分离处理。
📚 详细文档
每份文档均包含:功能说明、实现方法、请求参数、返回示例与典型调用方式。
⚠️ 免责声明
- 本项目仅供学习、研究与技术交流,严禁用于任何商业用途。
- 本项目仅作为官方公开接口的智能聚合与转发。
- 使用本项目造成的任何后果(包括但不限于账号封禁、数据异常、法律风险等)均由使用者本人承担,项目作者不承担任何责任。
- 请遵守中国法律法规及 12306 官方相关规定,合理合规使用。
📄 License
⭐ 如果这个项目对你有帮助,欢迎 Star 支持!
來源:README.md,提交 413e3cb
工具
0版本歷史
1- v0.3.1最新Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分