Xby 12306 Ticket Purchase Search — DSH Plugin for DeepSeek…

README

xby-12306-ticket-purchase-search

DeepSeek Harness (DSH) 的插件：12306购票搜索服务

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

功能

set_xby_apikey — 在聊天中设置 API 密钥（自动持久化，重启有效）
get_current_date — 获取当前日期，以上海时区（Asia/Shanghai, UTC+8）为准，返回格式为 "yyyy-MM-dd"。主要用于解析用户提到的相对日期（如“明天”、“下周三”），提供准确的日期输入。
get_stations_code_in_city — 通过中文城市名查询该城市所有火车站的名称及其对应的 station_code，结果是一个包含多个车站信息的列表。
get_station_code_of_citys — 通过中文城市名查询代表该城市的 station_code。此接口主要用于在用户提供城市名作为出发地或到达地时，为接口准备 station_code 参数。
get_station_code_by_names — 通过具体的中文车站名查询其 station_code 和车站名。此接口主要用于在用户提供具体车站名作为出发地或到达地时，为接口准备 station_code 参数。
get_station_by_telecode — 通过车站的 station_telecode 查询车站的详细信息，包括名称、拼音、所属城市等。此接口主要用于在已知 telecode 的情况下获取更完整的车站数据，或用于特殊查询及调试目的。一般用户对话流程中较少直接触发。
get_tickets — 查询12306余票信息。
get_interline_tickets — 查询12306中转余票信息。尚且只支持查询前十条。
get_train_route_stations — 查询特定列车车次在指定区间内的途径车站、到站时间、出发时间及停留时间等详细经停信息。当用户询问某趟具体列车的经停站时使用此接口。

安装

方式一：从 GitHub 直接安装（推荐）

# 格式: dsh plugin --profile <profile> add github:<owner>/<repo>
dsh plugin --profile web add github:xby_skill/xby-12306-ticket-purchase-search

方式二：从本地目录安装（开发模式）

# 仅用于本地开发调试
dsh plugin --profile web add /absolute/path/to/xby-12306-ticket-purchase-search

方式三：通过 cordis.patch.yml 开发调试

dsh web --profile web --patch /absolute/path/to/dsh-ocr-plugin/cordis.patch.yml

配置

获取 API 密钥

前往小笨羊官网注册并获取 API 密钥。