Top AI Repos — open-source AI, indexed and scored
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
This is a 12306 ticket search server based on the Model Context Protocol (MCP).
| Date | Stars |
|---|---|
| 2026-07-31 | 1124 |
| 2026-08-04 | 1130 |
| 2026-08-06 | 1130 |
Today
— stars today
This week
— stars this week
This month
— stars this month
Momentum
60.0
growth rate 0.00%/day
# <div align="center">12306-mcp</div>
<div align="center">
[](https://github.com/Joooook)
[](https://space.bilibili.com/3546386788255839)
</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">
| 功能描述 | 状态 |
|------------------------------|--------|
| 查询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>
~~~bash
git clone https://github.com/Joooook/12306-mcp.git
npm i
~~~
## <div align="center">▶️Quick Start</div>
### CLI-stdio
~~~bash
npx -y 12306-mcp
~~~
### CLI-http
~~~bash
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
~~~json
{
"mcpServers": {
"12306-mcp": {
"command": "npx",
"args": [
"-y",
"12306-mcp"
]
}
}
}
~~~
### Docker-stdio
~~~bash
docker build . -t 12306-mcp
docker run --rm -it 12306-mcp npx 12306-mcp
~~~
### Docker-http
~~~bash
docker build . -t 12306-mcp
docker run -p [your_port]:8080 -d 12306-mcp npx 12306-mcp --port 8080
~~~
## <div align="center">📚Documentation</div>
- [服务原理详解](./docs/principle.md) 12306-MCP服务的工作原理
- [架构图](./docs/architecture.md) 12306-MCP服务的架构图
## <div align="center">👉️Reference</div>
- [modelcontextprotocol/modelcontextprotocol](https://github.com/modelcontextprotocol/modelcontextprotocol)
- [modelcontextprotocol/typescript-sdk](https://github.com/modelcontextprotocol/typescript-sdk)
## <div align="center">💭Murmurs</div>
本项目仅用于学习，欢迎催更。
## <div align="center">🎫Badges</div>
<div align="center">
<a href="https://glama.ai/mcp/servers/@Joooook/12306-mcp">
<img width="380" height="200" src="https://glama.ai/mcp/servers/@Joooook/12306-mcp/badge" alt="12306-mcp MCP server" />
</a>
[](https://mseep.ai/app/joooook-12306-mcp)
</div>
## <div align="center">☕️Donate</div>
请我喝杯奶茶吧。
<div align="center">
<a href="https://afdian.com/item/2a0e0cdcadf911ef9f725254001e7c00">
<img src="https://s2.loli.net/2024/11/29/1JBxzphs7V6WcK9.jpg" width="500px">
</a>
</div>
Excerpt of 3,747 characters
Read on GitHub
81
3
2
Charles · ByteDance Seed · China
2
1
1
Frank Fiegel · Glama
1
Lawrence Sinclair · @EastAgile · United States
1
1
Would you bet a product on this? Bounded 0–100 and slow moving.
matched fp:8d5abafe9849333d, topic:mcp, topic:mcp-server, desc:model context protocol