World Monitor
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
MCP server for China Railway 12306 ticket availability: schedules and seats by Chinese station name.
This one is in the “Apps that connect to AI” tab, which is ordered without stars, in this order
| 1. In Claude’s connector directory | No | |
|---|---|---|
| 2. Tried by our team | No | |
| 3. Works for Thai users | No | |
| 4. Usage without stars | 15/100 | Popularity 0 · Freshness 7 · Still answering 8 · Likes from users +0 |
| 5. Listed on | 2026-09-03 |
Likes from users: 0 · Adds at most 5 points to the order (1 per person). It cannot be bought.
Quality: Passed 4/5 basic checks (shown, not used for ordering)
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install China 12306 Train Tickets MCP. Follow https://mcp.popnx.com/i/cn-pianam-12306-train-mcp.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 4/5 checks · What you ask goes through the maker’s server (mcp.pianam.cn) · ✓ Commands checked Nov 13, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude · about 2 min
No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it
CustomizeConnectors
Copy each value into the field with the same name in Claude, then click Continue
China 12306 Train Tickets MCPhttps://mcp.pianam.cn/train-mcp/mcpClick Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add
+ConnectorsChina 12306 Train Tickets MCP
Use China 12306 Train Tickets MCP and tell me what you can do for me, then show me one thing✓ If Claude says it is using China 12306 Train Tickets MCP or shows a China 12306 Train Tickets MCP tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with ChatGPT, depending on your plan
Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only
Plugins+Add custom MCP server
Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin
China 12306 Train Tickets MCPhttps://mcp.pianam.cn/train-mcp/mcpStart a new chat and pick China 12306 Train Tickets MCP from your plugins before typing
Use China 12306 Train Tickets MCP and tell me what you can do for me, then show me one thing✓ If ChatGPT says it is using China 12306 Train Tickets MCP or shows a China 12306 Train Tickets MCP tool in the answer, you are connected
Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Claude Code · about 2 min
No key, nothing to install
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --transport http --scope user 12306-train https://mcp.pianam.cn/train-mcp/mcpYou should see China 12306 Train Tickets MCP listed as connected
Use China 12306 Train Tickets MCP and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using China 12306 Train Tickets MCP or shows a China 12306 Train Tickets MCP tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor · about 2 min
No key, nothing to install
Use China 12306 Train Tickets MCP and tell me what you can do for me, then show me one thing✓ If Cursor says it is using China 12306 Train Tickets MCP or shows a China 12306 Train Tickets MCP tool in the answer, you are connected
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code · about 2 min
No key, nothing to install
Use China 12306 Train Tickets MCP and tell me what you can do for me, then show me one thing✓ If VS Code says it is using China 12306 Train Tickets MCP or shows a China 12306 Train Tickets MCP tool in the answer, you are connected
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
Address for apps that connect over the web
https://mcp.pianam.cn/train-mcp/mcpJSON settings are under “For developers” below
Claude Code
claude mcp add --transport http --scope user 12306-train https://mcp.pianam.cn/train-mcp/mcpCursor (~/.cursor/mcp.json)
{
"mcpServers": {
"12306-train": {
"url": "https://mcp.pianam.cn/train-mcp/mcp"
}
}
}VS Code (mcp.json)
{
"servers": {
"12306-train": {
"type": "http",
"url": "https://mcp.pianam.cn/train-mcp/mcp"
}
}
}These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Connect over the internet in
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
Tool names and descriptions exactly as the server reported them on Nov 15, 2026. The maker wrote them, not us; we show them as plain text.
query_train_tickets查询中国大陆12306火车票余票信息。参数from_city出发城市/车站中文名,to_city到达城市/车站中文名,date出发日期格式YYYY-MM-DD;留空默认明天。
search_station按关键词搜索12306车站名称,返回匹配的车站中文名列表。不确定城市有哪些车站时使用。
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026
The publisher (mcp.pianam.cn) is not the repo owner (boy-373); someone else may have listed it
Code last changed 2 months ago
Uses MIT
No sign-in needed
Read 2 tool descriptions and found no hidden instructions to the AI
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/cn-pianam-12306-train-mcp)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 4 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
The registry does not list a required key, though some servers ask you to sign in on first use.
It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.
The GitHub repo last changed 2 months ago, and the latest version (1.0.0) reached the registry 3 months ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).
In the same category: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Manage monitors, status pages, incidents and maintenances in your openstatus workspace.
Validate oh-my-posh configurations and segment snippets against the official schema.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.
| This one China 12306 Train Tickets MCP | World Monitor | openstatus | Oh My Posh Validator | Strata | Jitsu | |
|---|---|---|---|---|---|---|
| Runs where | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install |
| Needs a key | No | No | No | No | No | No |
| Add with + in Claude | No | No | No | No | No | No |
| Basic checks | 4/5 | 4/4 | 4/4 | 4/4 | 1/4 | 4/4 |
| License | MIT | AGPL-3.0 | AGPL-3.0 | MIT | Apache-2.0 | MIT |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
Query China Railway 12306 ticket availability from any MCP client — train schedules and remaining seats by Chinese station name and date. Read-only, no booking, no account.
https://mcp.pianam.cn/train-mcp/mcp
Transport: Streamable HTTP (MCP 2025-03-26 compatible). No authentication required.
Add this to your MCP client's mcpServers configuration (Claude Desktop claude_desktop_config.json, Cursor mcp.json, Cline, Cherry Studio, etc.):
{
"mcpServers": { "12306-train": { "type": "http", "url": "https://mcp.pianam.cn/train-mcp/mcp" } } }
Clients that do not accept
"type": "http"(some Cherry Studio / older
Cline versions) accept the same entry with just
"url".
| Tool | Parameters | Returns |
|---|
| query_train_tickets(from_city, to_city, date="") | from_city / to_city: Chinese city or station names, e.g. "青岛", "北京南". date: YYYY-MM-DD; empty defaults to tomorrow. 12306's booking window is usually 15 days. | Train list with train number, departure/arrival stations & times, duration, and remaining seats per class (business/first/second class, soft/hard sleeper, hard seat, no-seat). | | search_station(keyword) | keyword: e.g. "北京". | Fuzzy-matches station names (returns up to 30: 北京, 北京南, 北京西, 北京北 …) when you are not sure which station to use. |
kyfw.12306.cn/otn/leftTicket/...) — read-only queries only; this server cannot book tickets, please buy via the official 12306 app/website.git clone https://github.com/boy-373/12306-train-mcp.git
cd 12306-train-mcp pip install -r requirements.txt python train_mcp_server.py
Then point your MCP client at http://127.0.0.1:8003/mcp. No API keys or accounts are ever required.
Option A — pull the pre-built image (fastest, no build):
docker run -d -p 8000:8000 --name 12306-train-mcp ghcr.io/boy-373/12306-train-mcp:latest
Option B — build from source:
git clone https://github.com/boy-373/12306-train-mcp.git
cd 12306-train-mcp docker build -t 12306-train-mcp . docker run -d -p 8000:8000 --name 12306-train-mcp 12306-train-mcp
Then point your MCP client at http://127.0.0.1:8000/mcp. The container listens on 0.0.0.0:8000 by default (override with -e MCP_PORT=9000 and adjust -p accordingly). No API keys or accounts required.
train_stations.json — bundled 12306 station name → telegraph-code table (auto-refreshed from 12306 every 7 days).train_mcp_server.py — the MCP server (FastMCP, Streamable HTTP transport).rate_limit.py — lightweight per-IP sliding-window rate-limit middleware (200 req/min default).requirements.txt — mcp, uvicorn, starlette.server.json — official MCP Registry manifest (remote server entry, ready to publish with mcp-publisher).smithery.yaml / glama.json — directory listing metadata.`query_train_tickets(from_city, to_city, date="")`
| Parameter | What to pass | Notes |
|---|---|---|
from_city / to_city | Chinese station or city names, e.g. "青岛", "北京", "上海虹桥" | A city name works when the city has one main station; for multi-station cities use the exact station name. Not sure? Call search_station("北京") first — it returns 北京/北京南/北京西/北京北… |
date | YYYY-MM-DD, e.g. "2026-09-20" | Optional — defaults to tomorrow when empty. 12306's pre-sale window is 15 days (dates further out return an error or empty results). |
Why you may get an HTTP 400 / error result:
YYYY-MM-DD (2026/09/20, 2026年9月20日, Sep 20 all fail)."qingdao"), or a vague nickname the code table doesn't contain. Fix: call search_station with a keyword and copy the exact name."北京" usually resolves to 北京 station, but if you want a specific station pass "北京南" / "北京西" explicitly.Correct call examples:
query_train_tickets(from_city="青岛", to_city="北京", date="2026-09-20")
query_train_tickets(from_city="北京南", to_city="上海虹桥") # date omitted -> tomorrow search_station(keyword="上海") # -> 上海/上海南/上海虹桥/上海西…
A successful response returns 车次总数 plus a 车次 list (train number, departure/arrival station & time, duration, and remaining seats per class). An unrecognized station returns {"error": "出发站「…」无法识别,可用 search_station 工具查车站名"} — simply re-call with the exact name.
`query_train_tickets(from_city, to_city, date="")` 参数说明
| 参数 | 填什么 | 注意 |
|---|---|---|
from_city / to_city | 中文车站名或城市名,如 "青岛"、"北京"、"上海虹桥" | 城市只有一个主车站时填城市名即可;多车站城市建议填具体车站名。不确定时先调 search_station("北京"),会返回 北京/北京南/北京西/北京北 等准确站名 |
date | YYYY-MM-DD 格式,如 "2026-09-20" | 可留空,留空默认查明天;12306 预售期通常为 15 天,超出预售期的日期会查询失败或无结果 |
返回 400 / 错误结果的常见原因:
YYYY-MM-DD,2026/09/20、2026年9月20日、Sep 20 等写法都会失败;"qingdao")、或码表中没有的俗称都会无法识别。解决方法:先用 search_station 关键词搜索,复制返回的准确站名;"北京" 一般能匹配到「北京」站,但要去特定车站请明确传 "北京南"、"北京西" 等;正确调用示例:
query_train_tickets(from_city="青岛", to_city="北京", date="2026-09-20")
query_train_tickets(from_city="北京南", to_city="上海虹桥") # date 留空 -> 默认明天 search_station(keyword="上海") # 返回 上海/上海南/上海虹桥/上海西…
调用成功会返回 车次总数 和 车次 列表(车次号、出发/到达站与时间、历时、各席别余票);站名无法识别时返回 {"error": "出发站「…」无法识别,可用 search_station 工具查车站名"},换成准确站名重试即可。
一句话:直接用中文站名查 12306 余票,数据来自 12306 官方公开查询接口,纯只读。
在线直连地址(免费、无需 Key、开箱即用):https://mcp.pianam.cn/train-mcp/mcp
在 MCP 客户端(Claude Desktop / Cursor / Cherry Studio / Cline 等)的配置里加入:
{
"mcpServers": { "12306-train": { "type": "http", "url": "https://mcp.pianam.cn/train-mcp/mcp" } } }
工具:
query_train_tickets(from_city, to_city, date):查余票。出发/到达站直接给中文城市或车站名(如「青岛」「北京南」),日期格式 YYYY-MM-DD,留空默认明天;返回车次、出发到达时间、历时及商务座/一等座/二等座/软卧/硬卧/硬座/无座等余票。search_station(keyword):不确定城市有哪些车站时模糊搜索站名(如「北京」返回 北京/北京南/北京西/北京北 等)。服务特性:数据源全部为公开接口、无需注册/付费;服务端内存缓存、失败自动降级/切换备用通道;单 IP 限流 200 次/分钟。
本地部署:
git clone https://github.com/boy-373/12306-train-mcp.git
cd 12306-train-mcp pip install -r requirements.txt python train_mcp_server.py
Docker 自托管:
# 方式一:直接拉预构建镜像(最快,无需构建)
docker run -d -p 8000:8000 --name 12306-train-mcp ghcr.io/boy-373/12306-train-mcp:latest
git clone https://github.com/boy-373/12306-train-mcp.git && cd 12306-train-mcp docker build -t 12306-train-mcp . docker run -d -p 8000:8000 --name 12306-train-mcp 12306-train-mcp
容器默认监听 0.0.0.0:8000(可用 -e MCP_PORT=端口 改),无需任何 API Key 或账号。
MIT © 2026 boy-373
One-click install for Smithery-supported clients (Claude Desktop, Cursor, etc.):
Or run:
npx -y @smithery/cli install 1561852680/12306-train-mcp --client claude
We host a free MCP aggregation gateway: your AI assistant (Cherry Studio, Claude Desktop, Cursor, Cline — any MCP client) discovers and uses MCP tools through a single URL:
https://mcp.pianam.cn/ai/mcp
Add it once, then talk in plain language — the AI automatically searches → inspects → calls the right MCP for you.
📖 3-step setup guide / 中文接入教程: https://mcp.pianam.cn/ai-gateway