铁路票务查询工具

mcporter铁路查询

使用mcporter CLI通过12306查询中国火车票的OpenClaw技能。

概述

该技能提供了搜索G/D/C火车票、检查火车时刻表、查询座位可用性和计划中国城市之间铁路旅行的工具。它支持按日期、时间范围、列车类型和排序结果进行过滤。

项目结构

mcporter铁路查询/ ├── scripts/#Shell辅助脚本 ├── 参考/#车站代码参考 ├── README.md ├── README_zh.md ├── 技能.md ├── 安全.md └── 许可证

先决条件

1. 安装mcporter命令行界面： npm install -g mcporter
2. 在中配置12306 MCP服务器 ~/.mcporter/mcporter.json
   复制

     {
       "mcpServers": {
          "12306": {
             "type": "sse",
              "url": "http://127.0.0.1:8080/sse",
             "name": "12306 高铁动车查询",
             "description": "查询高铁（G开头）和动车（D开头）余票，支持出发站、到达站、日期、时间段过滤。只返回G/D车次。",
             "enabled": true
           }
       }
    }
   

3. 确保MCP服务器正在运行

安装

这是一个OpenClaw技能。使用以下方式安装：

openclaw skills install mcporter-railway-query.skill

用法

该技能提供了几个辅助脚本：

查询下午列车（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 "上海虹桥"

直接mcporter命令

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

特性

• 查询带发车时间过滤的火车票
• 支持G（高速）、D（子弹头列车）和C（城市列车）列车
• Seat availability checking (商务座, 一等座, 二等座, etc.)
• 车站代码查找
• 综合车站代码参考表

常用站代码

看 references/station-codes.md 查看完整列表。

许可证

麻省理工学院

安全与合规

此项目是一个只读的OpenClaw技能，可调用 mcporter CLI作为其唯一的外部依赖：

• 不收集用户数据
• 不存储凭据
• 不进行订票
• 不绕过12306身份验证
• 不执行任意系统命令（仅 mcporter 具有用户控制的参数）
• 不写入本地文件系统
• 不打开网络侦听器
• 不包括混淆或加密的代码

所有查询均通过用户配置的官方12306 MCP接口执行。

此存储库仅包含辅助脚本和配置示例。