技能名称: Mcporter Railway Query
详细描述:

mcporter 铁路车票查询

使用 mcporter 命令行工具查询 12306 中国铁路车票信息。

前提条件

1. 1. 安装 mcporter CLI
2. 配置 12306 MCP 服务器
3. 确认 mcporter.json 配置路径（默认 ~/.mcporter/mcporter.json）

快速开始

1. 使用快捷脚本查询

bash

查询下午班次 (12:00-18:00，含 G/D/C 全部车型)

./scripts/query-afternoon.sh 2026-02-18 SHH KYH

查询全天班次（含 G/D/C 全部车型）

./scripts/query-tickets.sh 2026-02-18 AOH HZH

查询车站代码

./scripts/get-station-code.sh 上海虹桥

2. 直接 mcporter 命令

bash

基础查询

mcporter call 12306.get-tickets \
date=2026-02-18 \
fromStation=AOH \
toStation=HZH \
trainFilterFlags=GD \
--config ~/.mcporter/mcporter.json

下午班次

mcporter call 12306.get-tickets \ date=2026-02-18 \ fromStation=AOH \ toStation=HZH \ trainFilterFlags=GD \ earliestStartTime=12 \ latestStartTime=18 \ sortFlag=startTime \ --config ~/.mcporter/mcporter.json

工作流程

步骤 1: 获取车站代码

不知道车站代码时：

bash
mcporter call 12306.get-station-code-of-citys \
citys=上海|杭州 \
--config ~/.mcporter/mcporter.json

或查看参考表 station-codes.md

步骤 2: 查询车票

bash
mcporter call 12306.get-tickets \
date=YYYY-MM-DD \
fromStation=出发站代码 \
toStation=到达站代码 \
[可选过滤参数] \
--config ~/.mcporter/mcporter.json

步骤 3: 解析结果

• - 有票: 有票 或显示剩余票数 剩余X张票
• 无票: 无票
• *票: 特殊标记票

参数参考

参数	类型	默认值	说明
date	string	必填	日期格式 YYYY-MM-DD
fromStation

string | 必填 | 出发站代码 (如 SHH) | | toStation | string | 必填 | 到达站代码 (如 KYH) | | trainFilterFlags | string | | G=高铁, D=动车, GD=高铁+动车（空值=全部含G/D/C） | | earliestStartTime | number | 0 | 最早出发时间 (0-24) | | latestStartTime | number | 24 | 最晚出发时间 (0-24) | | sortFlag | string | | startTime/arriveTime/duration | | sortReverse | boolean | false | 是否倒序 | | limitedNum | number | 0 | 限制结果数量 | | format | string | text | text/json/csv |

常用车站代码

城市	代码	城市	代码
上海	SHH	上海虹桥	AOH
杭州

HZH | 无锡 | WXH | | 江阴 | KYH | 南京南 | NKH |

完整列表见 station-codes.md

故障排除

mcporter 未找到

bash npm install -g mcporter

12306 MCP 未配置

创建 ~/.mcporter/mcporter.json 配置文件。

查询无结果

• - 确认车站代码正确
• 确认日期格式为 YYYY-MM-DD
• 检查 mcporter.json 路径

示例

更多查询示例见 query-examples.md