mcp-server-12306
by drfccv
12306 MCP Server is a high-performance train ticket query back-end system based on Model Context Protocol (MCP). It provides official 12306 real-time data services through standardized interfaces, including core functions such as remaining ticket inquiries, station information, train stops, and transfer plans.
271stars
38forks
Python
Added 1/25/2026
MCP Servers12306mcp-server
Installation
# Add to your Claude Code skills
git clone https://github.com/drfccv/mcp-server-12306🚄 MCP Server 12306
✨ 项目简介
MCP Server 12306是一款基于 Model Context Protocol (MCP) 的高性能火车票查询后端，支持官方 12306 余票、票价、车站、经停、换乘查询以及智能时间工具，适配 AI/自动化/智能助手等场景。界面友好，易于集成，开箱即用。
🚀 功能亮点
- 实时余票/车次/座席/时刻/换乘一站式查询
- 全国车站信息管理与模糊搜索
- 官方经停站、一次中转方案全支持
- 实时查询各车次票价信息
- 智能时间工具，支持时区和时间戳
- Streamable HTTP/STDIO传输协议，支持MCP 2025-03-26标准
- FastAPI异步高性能，秒级响应
- MCP标准，AI/自动化场景即插即用
🛠️ 快速上手
本项目支持两种运行模式：
- Stdio 模式：适用于 Claude Desktop 等本地 MCP 客户端（推荐）。
- Streamable HTTP 模式：适用于远程部署或通过 SSE/Post 访问。
模式 1：Stdio 模式（Claude Desktop 推荐）
在此模式下，MCP Server 通过标准输入/输出与客户端通信，无需占用网络端口。
方式 A：使用 uvx（推荐）
uvx 是 uv 包管理器提供的工具，环境隔离且启动极快。
{
"mcpServers": {
"12306": {
"command": "uvx",
"args": ["mcp-server-12306"]
}
}
}
方式 B：使用 pipx
如果您更习惯使用 pipx：
{
"mcpServers": {
"12306": {
"command": "pipx",
"args": ["run", "--no-cache", "mcp-server-12306"]
}
}
}
方式 C：本地源码运行
适用于开发者调试：
{
"mcpServers": {
"12306": {
"command": "uv",
"args": ["run", "python", "-m", "mcp_12306.cli"],
"cwd": "/path/to/mcp-server-12306"
}
}
}