12306-mcp

12306-mcp 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大语言模型（LLM）提供标准化的 12306 火车票搜索能力。通过该工具，AI 助手可以直接调用接口查询车次、余票及价格信息，从而协助用户完成行程规划。

核心功能

• 标准化接口：遵循 MCP 协议规范，提供统一的工具调用方式，便于集成到支持 MCP 的 AI 客户端（如 Claude Desktop、Cursor 等）。
• 实时查询：直接对接 12306 数据源，提供准确的车次时刻表与票务状态。
• 灵活部署：支持本地 CLI 运行、HTTP 服务模式以及 Docker 容器化部署，适应不同的使用场景。

安装与启动

该项目基于 Node.js 开发，使用前请确保已安装 Node.js 环境。

1. 源码安装

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

2. 快速启动

• CLI 标准输入输出模式（适用于本地调试或直接通过 stdio 连接 MCP 客户端）：

  npx -y 12306-mcp
  

• HTTP 服务模式（适用于远程调用或作为独立服务运行）：

  npx -y 12306-mcp --port 8080
  

3. Docker 部署

• 构建镜像：

  docker build . -t 12306-mcp
  

• 运行容器：
  • Stdio 模式：docker run --rm -it 12306-mcp npx 12306-mcp
  • HTTP 模式：docker run -p 8080:8080 -d 12306-mcp npx 12306-mcp --port 8080

MCP 客户端配置

在支持 MCP 的客户端（如 Claude Desktop）中，可以通过以下配置添加该服务器：

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

适用场景

• 智能行程助手：结合 LLM 的自然语言理解能力，用户只需说出目的地和时间，AI 即可自动查询并推荐合适的车次。
• 自动化工作流：集成到个人助理 Agent 中，实现定期的票务监控或抢票提醒。
• 开发者测试：为需要模拟真实票务数据的 AI 应用提供稳定的数据源。

12306-mcp 通过标准化的协议降低了 AI 访问复杂公共数据服务的门槛，为构建更实用的出行类 AI 应用提供了基础支持。