返回 MCP 目录
public公开dns本地运行

12306购票搜索服务器

基于MCP协议的12306火车票查询服务,提供车站查询、余票搜索、中转票查询等购票相关功能接口

article

README

🚀 12306购票搜索服务器

本项目是基于 Model Context Protocol (MCP) 的12306购票搜索服务器。它提供了简单的API接口,方便大模型利用这些接口搜索12306的购票信息,为用户提供了便捷的车票查询途径。

🚀 快速开始

本MCP服务封装了一系列工具,模型可通过标准化接口调用这些工具的功能。

✨ 主要特性

  • 提供多种与车站和车票信息查询相关的API接口,方便大模型调用。
  • 支持不同的服务配置方式,如SSE、STREAMABLE HTTP和STDIO。

📚 详细文档

🔍 工具列表

本MCP服务封装了以下工具,模型可通过标准化接口调用这些功能: | 工具 | 描述 | | ---- | ---- | | 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 | 查询特定列车车次在指定区间内的途径车站、到站时间、出发时间及停留时间等详细经停信息。当用户询问某趟具体列车的经停站时使用此接口。 |

🔍 检查服务

工具在线测试: https://mcp.xiaobenyang.com/inspector/1777316659202051

🔍 服务配置

如何获取 XBY-APIKEY ?

访问小笨羊科技网站 https://xiaobenyang.com,注册用户即可获得APIKEY。

SSE

{
  "mcpServers": {
    "12306购票搜索服务器": {
      "headers": {
        "XBY-APIKEY": "<YOUR_XBY_APIKEY>"
      },
      "type": "sse",
      "url": "https://mcp.xiaobenyang.com/1777316659202051/sse"
    }
  }
}

STREAMABLE HTTP

{
  "mcpServers": {
    "12306购票搜索服务器": {
      "headers": {
        "XBY-APIKEY": "<YOUR_XBY_APIKEY>"
      },
      "type": "streamable_http",
      "url": "https://mcp.xiaobenyang.com/1777316659202051/mcp"
    }
  }
}

STDIO

{
    "mcpServers": {
        "12306购票搜索服务器": {
          "command": "npx",
          "args": [
            "-y",
            "xiaobenyang-mcp"
          ],
          "env": {
            "XBY_APIKEY": "<YOUR_XBY_APIKEY>",
            "mcpId": "1777316659202051",
          },
          "transport": "stdio"
        }
      }
}
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端