LogoSTMCP
Download
12306-mcp

12306-mcp

基于 Model Context Protocol (MCP) 的12306购票搜索服务器。提供了简单的API接口,允许大模型利用接口搜索12306购票信息。

Tools

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格式)

JSON Config

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

Useful Links

Information

Categories