12306-mcp

1. get-current-date

• 功能: 获取当前日期
• 描述: 以上海时区（Asia/Shanghai, UTC+8）为准，返回格式为 "yyyy-MM-dd"
• 用途: 主要用于解析用户提到的相对日期（如"明天"、"下周三"），为其他需要日期的接口提供准确的日期输入
• 参数: 无

2. get-stations-code-in-city

• 功能: 通过城市名查询所有火车站
• 描述: 通过中文城市名查询该城市所有火车站的名称及其对应的station_code
• 用途: 返回包含多个车站信息的列表
• 参数:
  • city: 中文城市名称（如："北京", "上海"）

3. get-station-code-of-citys

• 功能: 通过城市名查询代表该城市的车站编码
• 描述: 通过中文城市名查询代表该城市的station_code
• 用途: 主要用于在用户提供城市名作为出发地或到达地时，为接口准备station_code参数
• 参数:
  • citys: 要查询的城市，支持用|分割查询多个城市

4. get-station-code-by-names

• 功能: 通过具体车站名查询车站编码
• 描述: 通过具体的中文车站名查询其station_code和车站名
• 用途: 主要用于在用户提供具体车站名作为出发地或到达地时，为接口准备station_code参数
• 参数:
  • stationNames: 具体的中文车站名称，支持用|分割查询多个站点

5. get-station-by-telecode

• 功能: 通过车站telecode查询详细信息
• 描述: 通过车站的station_telecode查询车站的详细信息，包括名称、拼音、所属城市等
• 用途: 主要用于在已知telecode的情况下获取更完整的车站数据，或用于特殊查询及调试目的
• 参数:
  • stationTelecode: 车站的station_telecode（3位字母编码）

6. get-tickets

• 功能: 查询12306余票信息
• 描述: 查询指定日期、出发地、到达地的火车票余票信息
• 用途: 核心功能，用于查询火车票
• 参数:
  • date: 查询日期（yyyy-MM-dd格式）
  • fromStation: 出发地的station_code
  • toStation: 到达地的station_code
  • trainFilterFlags: 车次筛选条件（可选）
  • sortFlag: 排序方式（可选）
  • sortReverse: 是否逆向排序（可选）
  • limitedNum: 返回数量限制（可选）

7. get-interline-tickets

• 功能: 查询12306中转余票信息
• 描述: 查询需要中转换乘的火车票信息
• 用途: 用于查询直达车次不可用时的中转方案
• 参数:
  • date: 查询日期（yyyy-MM-dd格式）
  • fromStation: 出发地的station_code
  • toStation: 到达地的station_code
  • middleStation: 中转地的station_code（可选）
  • showWZ: 是否显示无座车（可选）
  • trainFilterFlags: 车次筛选条件（可选）
  • sortFlag: 排序方式（可选）
  • sortReverse: 是否逆向排序（可选）
  • limitedNum: 返回数量限制（可选，默认10）

8. get-train-route-stations

• 功能: 查询列车经停站信息
• 描述: 查询特定列车车次在指定区间内的途径车站、到站时间、出发时间及停留时间等详细经停信息
• 用途: 当用户询问某趟具体列车的经停站时使用
• 参数:
  • trainNo: 实际车次编号train_no
  • fromStationTelecode: 出发站的station_telecode
  • toStationTelecode: 到达站的station_telecode
  • departDate: 出发日期（yyyy-MM-dd格式）

{
    "mcpServers": {
        "12306-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "12306-mcp"
            ]
        }
    }
}