<div align="center">12306-mcp</div>

A 12306 ticket search server based on the Model Context Protocol (MCP). The server provides a simple API interface that allows users to search for 12306 tickets.

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

如需Skill -> https://github.com/Joooook/12306-skill

<div align="center">🚩Features</div>

<div align="center">⚙️Installation</div>

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

<div align="center">▶️Quick Start</div>

CLI-stdio

npx -y 12306-mcp

CLI-http

npx -y 12306-mcp --port [端口号]

Runtime requirements

The server requires Node.js 18 or newer. The npm run debug command uses MCP Inspector 2.0.0, which requires Node.js 22.19.0 or newer.

MCP sever configuration

{
    "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

<div align="center">📚Documentation</div>

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

<div align="center">👉️Reference</div>

• modelcontextprotocol/modelcontextprotocol
• modelcontextprotocol/typescript-sdk

<div align="center">💭Murmurs</div>

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

<div align="center">🎫Badges</div>

<div align="center">☕️Donate</div>

请我喝杯奶茶吧。