12306-mcp

# <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购票信息。 ## <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 [端口号] ~~~ ### 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>