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

</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购票信息。

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

| 功能描述 | 状态 | |------------------------------|--------| | 查询12306购票信息 | ✅ 已完成 | | 过滤列车信息 | ✅ 已完成 | | 过站查询 | ✅ 已完成 | | 中转查询 | ✅ 已完成 | | 其余接口，欢迎提feature | 🚧 计划内 |

</div> <div align="center"> <img src="https://s2.loli.net/2025/04/15/UjbrG5esaSEmJxN.jpg" width=800px/> </div> <div align="center"> <img src="https://s2.loli.net/2025/04/15/rm1j8zX7sqiyafP.jpg" width=800px/> </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 [端口号]

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>

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

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

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

<div align="center"> <a href="https://glama.ai...