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 建構,支援自動協定協商,可處理不同版本的握手流程。

相關

  • 專案
  • 專案
  • 專案
  • 專案
  • 專案