Back to search
12306-mcp
MCP serverGitHub
This is a 12306 ticket search server based on the Model Context Protocol (MCP).
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/joooook--12306-mcp)HTML
<a href="/listings/joooook--12306-mcp"><img src="/api/listings/joooook--12306-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
git clone https://github.com/Joooook/12306-mcp.git npm i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 123 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # <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>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.