12306 MCP Setup & Guide
io.mcp-cn.12306-mcp
12306的MCP服务器,支持12306的读取
Copy the install config on this page first, then verify docs and permissions upstream.
Popularity
Overview
12306的MCP服务器,支持12306的读取 12306 is a MCP Server listed from MCP Hub China. Transports: stdio. This page includes an overview, setup tutorial, install commands, and use cases for Trae, Tongyi Lingma, Cursor, Claude Code, and VS Code.
Use cases
AgentHub Verified AvailabilityTested & Ready
Automated pipeline validated install commands, protocol & client compatibility
Copy by platform
Choose your platform
- Open or create .cursor/mcp.json in your project root
- Click Copy config and paste; merge only this mcpServers entry if others exist
- Replace <placeholders> in env with real secrets (see Environment variables below)
- Save, then Cmd+Shift+P → Reload Window
{
"mcpServers": {
"io-mcp-cn-12306-mcp": {
"command": "npx",
"args": [
"-y",
"12306-mcp"
]
}
}
}Setup tutorial
- Open the 12306 page and confirm this MCP Server (source: MCP Hub China).
- Copy the Cursor, Claude Code, or VS Code snippet.
- Merge it into mcpServers and replace env placeholders with real secrets.
- Reload the window, then call the MCP tools from your agent chat.
Install commands
Install commands and setup steps are in the HTML so search engines and no-JS browsers can read them without running client JavaScript.
Claude Code (local)
- Install Claude Code CLI
- Copy the command below, replace <placeholders> with real env values, then run in terminal
- See Environment variables below if listed
claude mcp add io-mcp-cn-12306-mcp -- npx -y 12306-mcpCursor — .cursor/mcp.json (local)
- Open or create .cursor/mcp.json in your project root
- Click Copy config and paste; merge only this mcpServers entry if others exist
- Replace <placeholders> in env with real secrets (see Environment variables below)
- Save, then Cmd+Shift+P → Reload Window
{
"mcpServers": {
"io-mcp-cn-12306-mcp": {
"command": "npx",
"args": [
"-y",
"12306-mcp"
]
}
}
}VS Code — .vscode/mcp.json (local)
- Install GitHub Copilot in VS Code with MCP support
- Open or create .vscode/mcp.json in your project root
- Click Copy config and paste; merge only this mcpServers entry if others exist
- Replace <placeholders> in env with real secrets
- Save and Developer: Reload Window
{
"mcpServers": {
"io-mcp-cn-12306-mcp": {
"command": "npx",
"args": [
"-y",
"12306-mcp"
]
}
}
}Claude Desktop — claude_desktop_config.json (local)
- Open Claude Desktop claude_desktop_config.json (see remote guide for paths)
- Click Copy config and merge under mcpServers
- Replace <placeholders> in env with real secrets
- Fully quit and restart Claude Desktop
{
"mcpServers": {
"io-mcp-cn-12306-mcp": {
"command": "npx",
"args": [
"-y",
"12306-mcp"
]
}
}
}Trae — .trae/mcp.json (local)
- Trae → Settings → MCP, or edit .trae/mcp.json / global mcp.json
- Click Copy config and merge mcpServers
- Replace <placeholders> in env with real secrets
- Save and reload Trae
{
"mcpServers": {
"io-mcp-cn-12306-mcp": {
"command": "npx",
"args": [
"-y",
"12306-mcp"
]
}
}
}Cherry Studio — MCP settings (local)
- Cherry Studio → Settings → MCP Servers → Add (STDIO)
- Or import JSON: click Copy config and merge mcpServers
- Replace <placeholders> in env; ensure Node.js / uv (npx, uvx) are installed
- Enable the server and check tools load
{
"mcpServers": {
"io-mcp-cn-12306-mcp": {
"command": "npx",
"args": [
"-y",
"12306-mcp"
]
}
}
}Tongyi Lingma — MCP config (local)
- Lingma Settings → MCP → + → STDIO or config file
- Click Copy config and merge mcpServers
- Replace <placeholders> in env; need Node.js 18+ (npx) or uv (uvx)
- Confirm connected before using tools in agent chat
{
"mcpServers": {
"io-mcp-cn-12306-mcp": {
"command": "npx",
"args": [
"-y",
"12306-mcp"
]
}
}
}Windsurf — mcp_config.json (local)
- Edit ~/.codeium/windsurf/mcp_config.json
- Click Copy config and merge mcpServers (stdio same as Cursor)
- Replace <placeholders> in env, save, refresh Cascade
{
"mcpServers": {
"io-mcp-cn-12306-mcp": {
"command": "npx",
"args": [
"-y",
"12306-mcp"
]
}
}
}Cline — MCP Servers (local)
- Cline panel → Settings → MCP Servers
- Click Copy config and merge
- Replace <placeholders> in env, then save
{
"mcpServers": {
"io-mcp-cn-12306-mcp": {
"command": "npx",
"args": [
"-y",
"12306-mcp"
]
}
}
}WorkBuddy — .workbuddy/mcp.json (local)
- Edit ~/.workbuddy/mcp.json (user) or project .workbuddy/mcp.json
- Or Plugins → MCP Servers → Configure MCP and paste the JSON below
- Replace <placeholders> in env; on Windows prefer absolute paths for command/scripts
- Save, restart WorkBuddy, confirm connector status is green
{
"mcpServers": {
"io-mcp-cn-12306-mcp": {
"command": "npx",
"args": [
"-y",
"12306-mcp"
]
}
}
}Troubleshooting & Common ErrorsFAQ
Common connection errors and verified fixes for 12306
Getting 'connection closed' or exit code 1 in Cursor / Claude Code for 12306?
Usually caused by missing runtime paths or IDE environment inheritance. Fix steps: 1. Verify Node.js 18+ (npx) or Python 3.10+ (uvx) is installed; 2. Run 'which npx' or 'which uvx' in terminal, and replace 'command' with absolute path; 3. Reload or restart the client window after modifying config.
# Check binary path in terminal: which npx node -v
Getting 'spawn npx ENOENT' or 'command not found'?
The editor background process does not inherit your full terminal PATH. Solution: Globally install the package, or set the absolute binary path (e.g. C:\Program Files\nodejs\npx.cmd on Windows, or /usr/local/bin/npx on macOS).
Tool calls timing out or failing to download packages?
First-time package downloading might be slow or timeout due to network limits. Configure a reliable mirror or check outbound proxy settings.
Tool Mock Playground
Sandbox12306 Tool Interface Simulation · Preview tool schema & outputs without local runtime
{
"target": "12306",
"action": "execute",
"options": {
"mode": "standard",
"timeoutMs": 5000
}
}Click 'Run Mock' above
to preview the raw response returned to the LLM
Decision Guide: Why & When to Use
Assess suitability before installing to save trial-and-error time
- Feishu docs
- China maps routing
- WeCom notifications
- Teams with no China accounts
- Cross-border data compliance concerns
12306 + Scenario Prompt → Complete Agent Automation
MCP hands-on: install to visible results
Follow the full lab (expected UI/output + contrast checks). After installing this item, verify with the tutorial prompts.
Related resources
Agent Email
v0.6.1
io.github.UseJunior/email-agent-mcp
Local email connectivity for AI agents — read, draft, send, and organize Outlook mail via MCP
NexTool MCP for GLPI
v3.8.0
com.nextoolsolutions/glpi
MCP server for GLPI: tickets, ITIL, assets, knowledge base. GLPI 10/11. Not affiliated with Teclib'.
Exomem
v0.199.0
io.github.Artexis10/exomem
Local Markdown/Obsidian knowledge substrate for MCP agents with governed memory and hybrid search.
fastmcp-sqltools
v0.4.2
io.github.atarkowska/fastmcp-sqltools
A MCP server provides SQL database access with support for PostgreSQL, MySQL, and SQLite.
Black Friday MCP
v0.1.0
com.blackfridaymcp/deals
Live Amazon.com (US) deals in your AI chat: search deals, check a price, trending, gift ideas.
Salesforce
v0.3.0
io.github.mindstone/mcp-server-salesforce
Salesforce CRM MCP server: accounts, contacts, opportunities, leads, tasks, and custom objects
Often paired with
agent-bom registry
v0.115.4
io.clawhub.msaad00/agent-bom-registry
MCP server security registry and trust assessment — look up servers in the 1356-entry server security metadata registry, run pre-install marketplace checks, batch fleet risk scoring, assess skill file trust, and run SAST code scans. Use when the user mentions MCP server trust, registry lookup, marketplace check, or skill trust assessment.
agent-bom scan
v0.115.4
io.clawhub.msaad00/agent-bom-scan
Check vulnerabilities in a specified package/version, repository, container image, or SBOM, or inspect a specified CVE. Discover local MCP clients only when the user explicitly requests that discovery. Ask for the target when a request such as "verify" or "is this safe" does not identify one.
agent-bom discover gcp
v0.115.4
io.clawhub.msaad00/agent-bom-discover-gcp
Discover GCP-hosted AI agent and MCP-relevant assets from the operator's environment, emit canonical agent-bom inventory JSON, and scan it without giving agent-bom long-lived GCP credentials. Use when a user asks to inventory Vertex AI, Cloud Run, Cloud Functions, GKE, or agentic GCP infrastructure as canonical inventory.
agent-bom discover aws
v0.115.4
io.clawhub.msaad00/agent-bom-discover-aws
Discover AWS-hosted AI agent and MCP-relevant assets from the operator's environment, emit canonical agent-bom inventory JSON, and scan it without giving agent-bom long-lived cloud credentials. Use when a user asks to inventory AWS Bedrock, ECS, SageMaker, Lambda, EKS, Step Functions, EC2, or agentic AWS infrastructure as canonical inventory. Passing that inventory to agent-bom is optional and operator-chosen.
Keep exploring AgentHub
Most people compare similar tools or check scenario guides before installing—start here.
Listing badge: put AgentHub on your site
Copy either snippet into your project homepage, docs, or GitHub README. The badge is a hotlinked SVG — nothing to host — and it links back to this page so visitors can find the install steps.
<a href="https://myagenthub.cn/p/io.mcp-cn.12306-mcp" title="Listed on AgentHub: 12306" target="_blank" rel="noopener">
<img src="https://myagenthub.cn/badge/io.mcp-cn.12306-mcp?lang=en" alt="Listed on AgentHub: 12306" height="20" style="border:0"/>
</a>[](https://myagenthub.cn/p/io.mcp-cn.12306-mcp)Badges are generated on the fly from /badge/<package-id>, so name and listing changes propagate automatically. Keep the link target unchanged — it is what counts as the referral.
Unified Manifest
{
"id": "io.mcp-cn.12306-mcp",
"type": "mcp-server",
"version": "latest",
"displayName": "12306",
"description": "12306的MCP服务器,支持12306的读取",
"author": {
"name": "joooook"
},
"iconUrl": "https://play-lh.googleusercontent.com/E5mFuQ2Y6Mt699GeFq--ff1ubXeP54yXXvb0-fwIYC0aV6JmFsRy3VhwECmI1eA8bdY",
"homepage": "https://mcp-cn.com/server/102",
"distribution": {
"packages": [
{
"registryType": "npm",
"identifier": "12306-mcp",
"runtimeHint": "npx",
"transport": "stdio"
}
],
"remotes": []
},
"dependencies": [],
"installTargets": [
"claude-code",
"claude-desktop",
"cursor",
"vscode",
"trae",
"cherry-studio",
"lingma",
"windsurf",
"cline",
"workbuddy"
],
"keywords": [
"use_count:34847",
"12306",
"MCP",
"12306",
"火车票"
],
"provenance": {
"origin": "mcp-cn",
"originalId": "12306-mcp",
"originalUrl": "https://mcp-cn.com/server/102",
"isOfficial": false,
"status": "active"
}
}