简介

基于Model Context Protocol (MCP)的12306车票查询服务器。该服务器提供了一个简单的API接口，允许用户搜索12306车票。

简介

基于Model Context Protocol (MCP)的12306车票查询服务器。该服务器提供了一个简单的API接口，允许用户搜索12306车票。

12306-mcp

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

🚩功能

⚙️安装

git clone https://github.com/Joooook/12306-mcp.git
npm i

▶️快速开始

CLI

npx -y 12306-mcp

MCP 服务器配置

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

Docker-stdio

docker build . -t 12306-mcp
docker run --rm -it 12306-mcp npx 12306-mcp

Docker-http

docker build . -t 12306-mcp
docker run -p [your_port]:8080 -d 12306-mcp npx 12306-mcp --port 8080

📚文档

• 服务原理详解 12306-MCP服务的工作原理
• 架构图 12306-MCP服务的架构图

👉️参考

• modelcontextprotocol/modelcontextprotocol
• modelcontextprotocol/typescript-sdk

💭碎碎念

本项目仅用于学习，欢迎催更。

🎫徽章

☕️捐赠

请我喝杯奶茶吧。

工具列表

• 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: 查询特定列车车次在指定区间内的途径车站、到站时间、出发时间及停留时间等详细经停信息。当用户询问某趟具体列车的经停站时使用此接口。

服务配置

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

来源

• 来源：ModelScope
• 链接：https://github.com/Joooook/12306-mcp