Summary
The 12306-mcp server provides an MCP interface for querying China Railways 12306 ticket information, enabling large language models to search and filter train tickets through a simple API. It offers capabilities including ticket search, train information filtering, station stop queries, and transfer route queries. The server solves the problem of integrating real-time Chinese railway ticket data into AI applications by exposing 12306 functionality through the Model Context Protocol.
Give your AI agent a complete email layer—sending, inbound inboxes, and sandbox testing.
Get 4K emails/month free →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Capacitor makes coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
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
请我喝杯奶茶吧。
Featured
Give your AI agent a complete email layer—sending, inbound inboxes, and sandbox testing.
Get 4K emails/month free →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Capacitor makes coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
