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.
How to install 12306-mcp?
joooook/12306-mcp
$git clone https://github.com/joooook/12306-mcpInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install 12306-mcp by running `git clone https://github.com/joooook/12306-mcp`, then use it for the current task and follow its documentation at https://github.com/joooook/12306-mcp.
README.md
| 1 | # <div align="center">12306-mcp</div> |
| 2 | |
| 3 | <div align="center"> |
| 4 | |
| 5 | [](https://github.com/Joooook) |
| 6 | [](https://space.bilibili.com/3546386788255839) |
| 7 |  |
| 8 |  |
| 9 |  |
| 10 |  |
| 11 | </div> |
| 12 | |
| 13 | 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. |
| 14 | |
| 15 | 基于 Model Context Protocol (MCP) 的12306购票搜索服务器。提供了简单的API接口，允许大模型利用接口搜索12306购票信息。 |
| 16 | |
| 17 | **如需Skill -> https://github.com/Joooook/12306-skill** |
| 18 | |
| 19 | ## <div align="center">🚩Features</div> |
| 20 | <div align="center"> |
| 21 | |
| 22 | | 功能描述 | 状态 | |
| 23 | |------------------------------|--------| |
| 24 | | 查询12306购票信息 | ✅ 已完成 | |
| 25 | | 过滤列车信息 | ✅ 已完成 | |
| 26 | | 过站查询 | ✅ 已完成 | |
| 27 | | 中转查询 | ✅ 已完成 | |
| 28 | | 其余接口，欢迎提feature | 🚧 计划内 | |
| 29 | |
| 30 | </div> |
| 31 | <div align="center"> |
| 32 | <img src="https://s2.loli.net/2025/04/15/UjbrG5esaSEmJxN.jpg" width=800px/> |
| 33 | </div> |
| 34 | <div align="center"> |
| 35 | <img src="https://s2.loli.net/2025/04/15/rm1j8zX7sqiyafP.jpg" width=800px/> |
| 36 | </div> |
| 37 | |
| 38 | ## <div align="center">⚙️Installation</div> |
| 39 | |
| 40 | ~~~bash |
| 41 | git clone https://github.com/Joooook/12306-mcp.git |
| 42 | npm i |
| 43 | ~~~ |
| 44 | |
| 45 | |
| 46 | ## <div align="center">▶️Quick Start</div> |
| 47 | |
| 48 | ### CLI-stdio |
| 49 | ~~~bash |
| 50 | npx -y 12306-mcp |
| 51 | ~~~ |
| 52 | |
| 53 | ### CLI-http |
| 54 | ~~~bash |
| 55 | npx -y 12306-mcp --port [端口号] |
| 56 | ~~~ |
| 57 | |
| 58 | ### MCP sever configuration |
| 59 | |
| 60 | ~~~json |
| 61 | { |
| 62 | "mcpServers": { |
| 63 | "12306-mcp": { |
| 64 | "command": "npx", |
| 65 | "args": [ |
| 66 | "-y", |
| 67 | "12306-mcp" |
| 68 | ] |
| 69 | } |
| 70 | } |
| 71 | } |
| 72 | |
| 73 | ~~~ |
| 74 | |
| 75 | ### Docker-stdio |
| 76 | ~~~bash |
| 77 | docker build . -t 12306-mcp |
| 78 | docker run --rm -it 12306-mcp npx 12306-mcp |
| 79 | ~~~ |
| 80 | |
| 81 | ### Docker-http |
| 82 | ~~~bash |
| 83 | docker build . -t 12306-mcp |
| 84 | docker run -p [your_port]:8080 -d 12306-mcp npx 12306-mcp --port 8080 |
| 85 | ~~~ |
| 86 | |
| 87 | |
| 88 | |
| 89 | ## <div align="center">📚Documentation</div> |
| 90 | |
| 91 | - [服务原理详解](./docs/principle.md) 12306-MCP服务的工作原理 |
| 92 | - [架构图](./docs/architecture.md) 12306-MCP服务的架构图 |
| 93 |  |
| 94 | |
| 95 | ## <div align="center">👉️Reference</div> |
| 96 | - [modelcontextprotocol/modelcontextprotocol](https://github.com/modelcontextprotocol/modelcontextprotocol) |
| 97 | - [modelcontextprotocol/typescript-sdk](https://github.com/modelcontextprotocol/typescript-sdk) |
| 98 | |
| 99 | ## <div align="center">💭Murmurs</div> |
| 100 | 本项目仅用于学习，欢迎催更。 |
| 101 | |
| 102 | ## <div align="center">🎫Badges</div> |
| 103 | <div align="center"> |
| 104 | <a href="https://glama.ai/mcp/servers/@Joooook/12306-mcp"> |
| 105 | <img width="380" height="200" src="https://glama.ai/mcp/servers/@Joooook/12306-mcp/badge" alt="12306-mcp MCP server" /> |
| 106 | </a> |
| 107 | |
| 108 | [](https://mseep.ai/app/joooook-12306-mcp) |
| 109 | |
| 110 | </div> |
| 111 | |
| 112 | ## <div align="center">☕️Donate</div> |
| 113 | 请我喝杯奶茶吧。 |
| 114 | <div align="center"> |
| 115 | <a href="https://afdian.com/item/2a0e0cdcadf911ef9f725254001e7c00"> |
| 116 | <img src="https://s2.loli.net/2024/11/29/1JBxzphs7V6WcK9.jpg" width="500px"> |
| 117 | </a> |
| 118 | </div> |
Related
6 picksType
- langchain-mcp-adaptersMake Anthropic Model Context Protocol (MCP) tools compatible with LangChain and LangGraph agents.Jul 2026
- mcporterTypeScript runtime and CLI for connecting to configured Model Context Protocol servers.Jul 2026
- mcp-proxyA MCP server which proxies requests to a remote MCP server over streamable HTTP or SSE.Jul 2026
- mcp-atlassianThe Model Context Protocol (MCP) Atlassian integration is an open-source implementation that bridges Atlassian products (Jira and Confluence) with AI language models following Anthropic's MCP specification.Jul 2026
- open-webuiOpen WebUIJul 2026
- rulesyncUnified AI rules management CLI tool that generates configuration files for various AI development toolsJul 2026
