{"repo":"drfccv/mcp-server-12306","free":true,"listed":false,"github":"https://github.com/drfccv/mcp-server-12306","clone":"git clone https://github.com/drfccv/mcp-server-12306.git","description":"12306 MCP Server​​ 是一个基于 ​​Model Context Protocol (MCP)​​ 的高性能火车票查询后端系统。它通过标准化接口提供官方 12306 的实时数据服务，包括余票查询、车站信息、列车经停站、中转换乘方案等核心功能。","language":"Python","stars":366,"topics":["12306","agent","ai","mcp","mcp-servers","mcp-tools"],"license":"MIT","category":"mcp-servers","readme_excerpt":"🚄 MCP Server 12306 基于 Model Context Protocol (MCP) 的 12306 火车票查询服务 支持 余票 / 票价 / 车站 / 经停 / 换乘 / 时间 六大查询能力，开箱即用，适配 AI 助手、自动化脚本、智能终端等场景。 --- 📑 目录 - ✨ 功能特性 - 🚀 快速开始 - 环境要求 - 方式一：Stdio 模式（本地客户端推荐） - 方式二：Streamable HTTP 模式（远程部署） - 方式三：Docker 部署 - 🛠️ 工具一览 - ⚙️ 配置项 - 🏗️ 项目结构 - 🧑‍💻 开发指南 - 📚 详细文档 - ⚠️ 免责声明 - 📄 License --- ✨ 功能特性 类别 能力 ------ ------ 🎫 余票查询 余票 / 车次 / 座席 / 时刻一站式查询，支持按车次过滤 💰 票价查询 实时查询各车次各席别票价（商务座 → 无座全覆盖） 🏙️ 车站搜索 全国 3382+ 车站，支持中文 / 拼音 / 简拼 / 三字码模糊搜索 🔄 中转换乘 官方换乘方案自动分页抓取，返回完整路径与等待时间 🛤️ 经停查询 查询指定列车全部经停站与到发时刻 🕐 时间工具 获取任意时区当前时间、相对日期计算，辅助选择出行日期 🔌 双传输模式 Stdio（本地）\\ Streamable HTTP（远程），同一核心实例共享 🔄 协议自动协商 基于 MCP SDK v2，自动兼容握手时代（2025-11-25）与现代协议（2026-07-28） --- 🚀 快速开始 环境要求 依赖 要求 ------ ------ Python = 3.10, 💡 推荐使用 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 端点： 端点 方法 说明 ------ ------ ------ /mcp POST / GET / DELETE MCP Streamable HTTP 协议入口 /health GET 健康检查（含已加载车站数、活跃会话数） /schema/tools GET 全部工具 JSON Schema / GET 服务信息（版本、协议版本、端点） 方式三：Docker 部署 --- 🛠️ 工具一览 工具名 功能 必填参数 -------- ------ ---------- query-tickets 余票 / 车次 / 座席 / 时刻一站式查询 from station 、 to station 、 train date query-ticket-price 实时查询车次票价 from station 、 to station 、 train date search-stations 车站模糊搜索（中文 / 拼音 / 简拼 / ","default_branch":null,"files":null,"tree":[],"storefront":"/r/drfccv","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/drfccv/mcp-server-12306/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}