How do I install the Mcporter Railway Query skill?

Run npx skillmds@latest add modbender/mcporter-railway-query-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Mcporter Railway Query safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Mcporter Railway Query?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Mcporter Railway Query free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Mcporter Railway Query?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Mcporter Railway Query by modbender

Name: Mcporter Railway Query
Rating: 4.5 (4 reviews)
Author: modbender

Mcporter Railway Query

Query and book Chinese railway tickets via 12306 using mcporter CLI. Use when user wants to search for G/D/C train tickets, check train schedules, query seat availability, or plan rail travel between Chinese cities. Supports filtering by date, time range, train type, and sorting results.

modbender Updated Sep 22, 2026 12 repo stars

File contents

mcporter Railway Ticket Query

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

Prerequisites

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

Quick Start

1. 使用快捷脚本查询

# 查询下午班次 (12:00-18:00)
./scripts/query-afternoon.sh 2026-02-18 SHH KYH

# 查询全天班次
./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=高铁+动车
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

---name: mcporter-railway-query-2description: Query and book Chinese railway tickets via 12306 using mcporter CLI. Use when user wants to search for G/D/C train tickets, check train schedules, query seat availability, or plan rail travel between Chinese cities. Supports filtering by date, time range, train type, and sorting results.---# mcporter Railway Ticket Query使用 mcporter 命令行工具查询 12306 中国铁路车票信息。## Prerequisites1. 安装 mcporter CLI2. 配置 12306 MCP 服务器3. 确认 mcporter.json 配置路径（默认 ~/.mcporter/mcporter.json）## Quick Start### 1. 使用快捷脚本查询```bash# 查询下午班次 (12:00-18:00)./scripts/query-afternoon.sh 2026-02-18 SHH KYH# 查询全天班次./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```## Workflow### Step 1: 获取车站代码不知道车站代码时：```bashmcporter call 12306.get-station-code-of-citys \ citys="上海|杭州" \ --config ~/.mcporter/mcporter.json```或查看参考表 [station-codes.md](references/station-codes.md)### Step 2: 查询车票```bashmcporter 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=高铁+动车 || 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](references/station-codes.md)## Troubleshooting### mcporter not found```bashnpm install -g mcporter```### 12306 MCP 未配置创建 ~/.mcporter/mcporter.json 配置文件。### 查询无结果- 确认车站代码正确- 确认日期格式为 YYYY-MM-DD- 检查 mcporter.json 路径## Examples更多查询示例见 [query-examples.md](references/query-examples.md)

Frequently asked questions