J
Joooook/12306-mcp
Search train tickets on 12306
View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site
Install & config
- Copy the command above
- Paste it as one entry under
mcpServersinclaude_desktop_config.json— local servers take command + args (example: clients) - Restart your client
Client config (built from the install command this repo gives)
{
"mcpServers": {
"joooook-12306-mcp": {
"command": "npx",
"args": ["-y", "12306-mcp"]
}
}
}Parsed from the README we fetched on 2026-11-07; we have not executed it.
command/args come from the install command the repository states. When it is ambiguous, the project README wins.
VS Code (.vscode/mcp.json - the key is servers)
{
"servers": {
"joooook-12306-mcp": {
"command": "npx",
"args": ["-y", "12306-mcp"]
}
}
}Same server, but VS Code keeps it under <code>servers</code>.
Claude Code (command line)
claude mcp add --transport stdio joooook-12306-mcp -- npx -y 12306-mcp
Claude Code does not read a config file; add the server with this command.
Key names differ by client: Clients & CLI
- Source
- collected from the abordage/awesome-mcp list · type: MCP server
- Harvest history
- first seen 2026-11-05 · last seen 2026-11-14 · seen 10× · listed by 10 sources
- Score
- score 1,003 · 10 sources · mcp
- Install
npx -y 12306-mcp
FAQ (answers come from our records)
How do I install it?
The repository provides this install command:
npx -y 12306-mcp. It comes from the repository itself; we cannot guarantee it runs as-is in your client.Who is it for?
We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
first catalogued 2026-11-05；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.
# 12306-mcp
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
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
## 🚩Features
| 功能描述 | 状态 |
| 查询12306购票信息 | ✅ 已完成 |
| 过滤列车信息 | ✅ 已完成 |
| 过站查询 | ✅ 已完成 |
| 中转查询 | ✅ 已完成 |
| 其余接口，欢迎提feature | 🚧 计划内 |
## ⚙️Installation
~~~bash
git clone https://github.com/Joooook/12306-mcp.git
npm i
~~~
## ▶️Quick Start
### 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
~~~
## 📚Documentation
服务原理详解 12306-MCP服务的工作原理
架构图 12306-MCP服务的架构图
## 👉️Reference
modelcontextprotocol/modelcontextprotocol
modelcontextprotocol/typescript-sdk
## 💭Murmurs
本项目仅用于学习，欢迎催更。
## 🎫Badges
## ☕️Donate
请我喝杯奶茶吧。
基于 Model Context Protocol (MCP) 的12306购票搜索服务器。提供了简单的API接口，允许大模型利用接口搜索12306购票信息。
如需Skill -> https://github.com/Joooook/12306-skill
## 🚩Features
| 功能描述 | 状态 |
| 查询12306购票信息 | ✅ 已完成 |
| 过滤列车信息 | ✅ 已完成 |
| 过站查询 | ✅ 已完成 |
| 中转查询 | ✅ 已完成 |
| 其余接口，欢迎提feature | 🚧 计划内 |
## ⚙️Installation
~~~bash
git clone https://github.com/Joooook/12306-mcp.git
npm i
~~~
## ▶️Quick Start
### 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
~~~
## 📚Documentation
服务原理详解 12306-MCP服务的工作原理
架构图 12306-MCP服务的架构图
## 👉️Reference
modelcontextprotocol/modelcontextprotocol
modelcontextprotocol/typescript-sdk
## 💭Murmurs
本项目仅用于学习，欢迎催更。
## 🎫Badges
## ☕️Donate
请我喝杯奶茶吧。
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/joooook-12306-mcp/)
- Source
- awesome · https://github.com/Joooook/12306-mcp
- Browse by field
- MCP servers
- Listed by
- 10 independent sources
- added
- today
More like this
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.