基於MCP 協定的12306 高效能查詢介面：實現AI 自動化購票的即插即用方案

12306 MCP Server：為AI 打造的高效能火車票查詢接口

12306 MCP Server 是一款開源的高效能後端服務，旨在將12306 的即時票務數據轉化為AI 智能體可直接調用的標準化能力。它透過MCP (Model Context Protocol) 協議，讓AI 助理能夠秒級取得餘票、車站及轉乘方案，無需複雜的介面解析即可實現自動化行程規劃。

核心功能與技術亮點

該服務不僅同步了官方的即時數據，更在互動體驗和響應速度上進行了深度優化：

• 全維度票務查詢： 一站式提供餘票、車次、座席及時刻表數據，確保資訊與官方同步。
• 智慧互動優化： 內建車站模糊搜索，即便輸入不精確也能快速定位；支援「明早」等相對日期解析，消除手動輸入日期的誤差。
• 高效率行程規劃： 支援查詢官方經停站及一次中轉方案，提升行程設計的彈性。
• 工業級性能架構： 基於 FastAPI 非同步框架與 Uvicorn 驅動，響應延遲極低。
• 標準化傳輸： 遵循MCP 2025-03-26 標準，支援SSE (Server-Sent Events) 串流傳輸，讓AI 回應更自然。

適用場景

• AI 智慧助理： 聊天機器人直接呼叫接口，為使用者即時查詢餘票或規劃路線。
• 自動化工具： 建立自動訂票腳本、日期提醒系統或行程監控工具。
• 企業級整合： 將火車票查詢模組快速嵌入企業旅遊平台或旅遊類App。

部署指南

方法一：本地環境部署

建議使用 Python 3.10+ 環境。推薦安裝 uv（高效能Python 套件管理器），其依賴安裝速度顯著優於pip。

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 

总结

12306 MCP Server 通过将复杂的票务数据标准化，消除了大模型解析 HTML 的痛点。凭借异步架构与即插即用的 Docker 镜像，它为开发者提供了一套安全、高效且易于扩展的火车票查询解决方案。

项目地址： https://github.com/drfccv/mcp-server-12306