drfccv/mcp-server-12306

12306 MCP Server​​ 是一个基于 ​​Model Context Protocol (MCP)​​ 的高性能火车票查询后端系统。它通过标准化接口提供官方 12306 的实时数据服务,包括余票查询、车站信息、列车经停站、中转换乘方案等核心功能。

解决的问题

该项目为 AI 助手和自动化脚本提供了一种访问 12306 官方系统实时中国铁路数据的方法。它弥合了 LLM 与实时列车信息之间的差距,使 AI 能够帮助用户搜索车票、查询价格和规划旅行路线,而无需手动搜索。

工作原理

该项目以 Model Context Protocol (MCP) 服务器的形式实现。它作为中介,连接到官方 12306 接口,并向 AI 客户端暴露多个专用工具。支持两种通信模式:Stdio(适用于本地客户端如 Claude Desktop 或 Cursor)和 Streamable HTTP(适用于远程部署)。

适用人群

  • 希望将火车票查询功能集成到工作流中的 AI 助手用户(如 Claude 或 Cursor)。
  • 开发旅行相关 AI 代理或自动化脚本的开发者。
  • 通过 Docker 部署远程 AI 工具服务的系统管理员。

主要亮点

  • 全面查询功能:支持车票余票、票价、车站搜索、中转换乘选项以及列车停靠顺序查询。
  • 智能车站搜索:支持使用中文、拼音或三位字母代码对 3,382+ 个车站进行模糊搜索。
  • 灵活部署:可通过 Stdio 本地运行,也可通过 HTTP 和 Docker 远程部署。
  • 协议兼容性:基于 MCP SDK v2 构建,支持自动协议协商,可处理不同版本的握手流程。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目