Content
# <div align="center">12306-mcp</div>
<div align="center">
[](https://github.com/Joooook)
[](https://space.bilibili.com/3546386788255839)




</div>
## <div align="center">👋Introduction</div>
This is 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购票信息
- 过滤列车信息
<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
~~~bash
npm run build
node ./build/index.js
~~~
### MCP sever configuration
~~~json
{
"mcpServers": {
"12306-mcp": {
"command": "npx",
"args": [
"-y",
"12306-mcp"
]
}
}
}
~~~
## <div align="center">✅Todo</div>
- 完成12306其余接口(中转,过站查询...)。
## <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">☕️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>