12306-mcp
Joooook · Joooook/12306-mcp
This MCP server allows AI agents to search for 12306 train tickets, filter results, and perform transfer queries.
This is a 12306 ticket search server based on the Model Context Protocol (MCP).
Preview
What you can do with it
- Find train tickets between specific stations for a given date.
- Filter train results by desired seat types or departure times.
- Check for connecting train options for complex routes.
Safety check
No risky patterns found in the files we scanned.
Automated scan of the repo files. Always review code you run.
From the README
12306-mcp
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
🚩Features
| 功能描述 | 状态 |
|---|---|
| 查询12306购票信息 | ✅ 已完成 |
| 过滤列车信息 | ✅ 已完成 |
| 过站查询 | ✅ 已完成 |
| 中转查询 | ✅ 已完成 |
| 其余接口，欢迎提feature | 🚧 计划内 |
⚙️Installation
git clone https://github.com/Joooook/12306-mcp.git
npm i
▶️Quick Start
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
📚Documentation
👉️Reference
💭Murmurs
本项目仅用于学习，欢迎催更。
🎫Badges
☕️Donate
请我喝杯奶茶吧。