12306 火车票查询 · 远程 MCP Server
China Railway 12306 train ticket query — free remote MCP server. No local install, no Node.js, no API key. Add one URL to your AI client (Claude Desktop, Cursor, Cline, any MCP-compatible client) and ask in plain language.
免费的 12306 火车票查询远程 MCP 服务。无需本地安装、无需 Node 环境、无需 API Key —— 在 AI 客户端填入一个 URL 即可直接用自然语言查车次、查余票。
- 🔌 远程直连 (Remote / Streamable HTTP):填 URL 就能用,不挑操作系统
- 🚄 全量车次:高铁 / 动车 / 普速,3300+ 火车站覆盖
- 🎫 实时余票:商务座 / 一等座 / 二等座 / 软卧 / 硬卧 / 硬座 / 无座
- 🆓 完全免费,数据来自 12306 官方公开查询接口
- 🔒 只读查询,不涉及登录、支付、个人信息
快速接入 / Quick Start
将以下配置加入你的 MCP 客户端配置文件:
{
"mcpServers": {
"12306-train": {
"url": "https://mcp.pianam.cn/train-mcp/mcp"
}
}
}
- Claude Desktop:Settings → Developer → Edit Config,粘贴上面的配置后重启
- Cursor:Settings → MCP → Add new MCP Server,选择 URL 方式填入
https://mcp.pianam.cn/train-mcp/mcp - Cline:MCP Servers → Configure,粘贴 JSON 配置
接入后直接用人话问:
“明天青岛去北京的高铁还有二等座吗?”“9月2号上海到北京的 G 字头车次”“帮我查下周末广州到武汉的火车票”
AI 会自动调用工具、解析车站、返回车次时刻与余票。
工具列表 / Tools
1. query_train_tickets
查询两地之间的火车车次与实时余票。Query trains and live seat availability between two cities.
| 参数 Parameter | 类型 Type | 必填 Required | 说明 Description |
|---|---|---|---|
from_city |
string | ✅ | 出发城市或车站名,如「青岛」「北京南」。Departure city/station, e.g. "Qingdao" |
to_city |
string | ✅ | 到达城市或车站名。Arrival city/station |
date |
string | ❌ | 出发日期 YYYY-MM-DD,留空默认明天;12306 预售期为 15 天。Travel date, defaults to tomorrow. |
返回内容:车次号、出发/到达站、出发/到达时间、历时,以及各席别余票(商务座/特等座、一等座、二等座、软卧、软座、硬卧、硬座、无座)。
2. search_station
按关键词模糊搜索车站,获取准确的车站名。Fuzzy search railway stations by keyword.
| 参数 Parameter | 类型 Type | 必填 Required | 说明 Description |
|---|---|---|---|
keyword |
string | ✅ | 车站或城市关键词,如「青岛」返回 青岛/青岛北/青岛西/青岛机场 |
响应示例 / Example Response
G69 北京南 07:00 → 青岛 10:38 (3h38m)
商务座: 有票 | 一等座: 5 张 | 二等座: 有票 | 无座: 无
G1099 北京南 07:35 → 青岛北 11:12 ...
说明 / Notes
- 数据来源:中国铁路 12306 官方公开查询接口(
kyfw.12306.cn),本站仅做转发与结构化解析。 - 只支持查询,不支持购票/抢票。购票请使用 12306 官方 App。
- Data source: China Railway 12306 public query API. Query only — no ticket booking.
- 本服务由 MCP Marketplace · mcp.pianam.cn 提供。该平台收录 28,000+ MCP 工具,并提供更多自营远程 MCP 服务。
License
MIT