Mcporter Railway Query

通过 mcporter CLI 查询中国铁路票务信息。适用于用户想要搜索 G/D/C 车票、查看列车时刻表、查询座位可用性或规划中国城市之间的铁路旅行。支持按日期、时间范围、列车类型进行筛选，并对结果进行排序。

Security Scan

This skill is a thin wrapper around the mcporter CLI for querying 12306 ticket info; its files and instructions are consistent with that purpose and do not request unrelated credentials or install arbitrary code.

Purpose & Capability

Name/description match the code and docs: helper shell scripts call the mcporter CLI to query 12306 MCP endpoints. The requested artifacts (mcporter CLI and a mcporter.json config) are expected for this functionality.

Instruction Scope

SKILL.md and scripts only instruct running mcporter with user-supplied parameters and reading a config file (default ~/.mcporter/mcporter.json). They do not attempt to read unrelated files, access other environment variables, or transmit data to hidden endpoints in the repository itself.

Install Mechanism

No install spec in the skill bundle; developer recommends installing mcporter via npm in documentation. The repository contains only small shell scripts and reference docs — no downloads or archive extraction from untrusted URLs.

Credentials

The skill declares no required environment variables or credentials. The only config referenced is the user's mcporter.json (expected to hold MCP server URL). There are no unrelated credentials requested.

Persistence & Privilege

The skill is not 'always' enabled, does not modify other skills or system-wide settings, and does not persist secrets. Scripts are runtime helpers only.

Assessment

This skill is a lightweight wrapper that runs the mcporter CLI; before installing, verify you trust the mcporter package source (npm) and inspect your ~/.mcporter/mcporter.json. The MCP server URL in that config is the endpoint that will receive your queries — prefer a trusted or local server (e.g., 127.0.0.1) to avoid sending requests to an unknown remote service. The scripts do not perform booking or store credentials, but they will call whatever MCP server you configure, so treat the server URL as sensitive and review it if you have privacy or security concerns.

mcporter Railway Ticket Query

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

Prerequisites

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

Quick Start

1. 使用快捷脚本查询

# 查询下午班次 (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 命令

# 基础查询
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

Workflow

Step 1: 获取车站代码

不知道车站代码时：

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

或查看参考表 station-codes.md

Step 2: 查询车票

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

Step 3: 解析结果

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

Parameters Reference

参数	类型	默认值	说明
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

Common Station Codes

城市	代码	城市	代码
上海	SHH	上海虹桥	AOH
杭州	HZH	无锡	WXH
江阴	KYH	南京南	NKH

完整列表见 station-codes.md

Troubleshooting

mcporter not found

npm install -g mcporter

12306 MCP 未配置

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

查询无结果

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

Examples

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