The 12306-mcp server provides functionalities for searching and filtering train ticket information:
Query tickets: Search for train tickets between stations on a specific date
Filter results: Filter by train types (G, D, Z, T, K, O, F, S) or specific flags (high-speed, smart trains)
Station information: Retrieve station codes for cities, query all stations within a city, or find codes for specific station names
Advanced routing: Perform intermediate station queries and transfer queries
Used as a donation platform where users can buy the developer a milk tea.
Linked to the developer's Bilibili profile, though no specific integration capabilities are described.
Referenced as the project repository platform, but not described as a service the MCP server integrates with.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@12306-mcpsearch for train tickets from Beijing to Shanghai tomorrow"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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购票信息。
🚩Features
功能描述 | 状态 |
查询12306购票信息 | ✅ 已完成 |
过滤列车信息 | ✅ 已完成 |
过站查询 | ✅ 已完成 |
中转查询 | ✅ 已完成 |
其余接口，欢迎提feature | 🚧 计划内 |
Related MCP server: Ticketmaster Discovery MCP Server
⚙️Installation
git clone https://github.com/Joooook/12306-mcp.git
npm i▶️Quick Start
CLI-stdio
npx -y 12306-mcpCLI-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-mcpDocker-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
请我喝杯奶茶吧。