12306-mcp — Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

Echtzeit-Ticketverfügbarkeit über Chinas offizielle 12306-Eisenbahn-API
Train filtering by seat type, departure time, and preferences
Transit stop and route information for any train number
Transferroutenplanung für mehrteilige Fahrten
Supports stdio and HTTP transport modes

Live-Demo

In der Praxis

12306-mcp-2.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "12306-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/Joooook/12306-mcp"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "12306-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/Joooook/12306-mcp"
      ]
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "12306-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/Joooook/12306-mcp"
      ]
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "12306-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/Joooook/12306-mcp"
      ]
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "12306-mcp-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/Joooook/12306-mcp"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "12306-mcp-2": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/Joooook/12306-mcp"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add 12306-mcp-2 -- TODO 'See README: https://github.com/Joooook/12306-mcp'

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: 12306-mcp

How to find the cheapest train between two cities with 12306-mcp

👤 Travelers planning trips within China ⏱ ~5 min beginner

Wann einsetzen: You need to compare train options between two Chinese cities and find the best deal.

Voraussetzungen

12306-mcp-Server läuft — npx -y 12306-mcp

Ablauf

Suchen Sie nach verfügbaren Zügen

Suchen Sie morgen nach Zügen von Peking nach Shanghai. Zeigen Sie mir alle verfügbaren Optionen mit Preisen und Sitzplatztypen.✓ Kopiert

→ Eine Tabelle der Züge mit Abfahrtszeiten, Dauer, Sitzklassen und Preisen
Nach Präferenz filtern

Welche davon hat Sitzplätze in der zweiten Klasse verfügbar und kommt vor 18:00 Uhr an?✓ Kopiert

→ Gefilterte Liste, die den Kriterien entspricht

Ergebnis: A clear comparison of train options to make a booking decision.

Fallstricke

Stationsnamen müssen genau mit der Datenbank von 12306 übereinstimmen — Benutzen Sie zunächst die Stationssuchfunktion, um den korrekten Stationsnamen zu bestätigen

Planen Sie eine Zugfahrt mit mehreren Etappen und Umstiegen mit 12306-mcp

👤 Reisende reisen in Städte ohne direkte Züge ⏱ ~10 min beginner

Wann einsetzen: Es gibt keinen direkten Zug zwischen Ihrem Herkunfts- und Zielort.

Voraussetzungen

12306-mcp-Server läuft — npx -y 12306-mcp

Ablauf

Übertragungsoptionen abfragen

Ich muss mit dem Zug von Chengdu nach Lhasa fahren. Finden Sie für mich Transferrouten mit der kürzesten Gesamtreisezeit.✓ Kopiert

→ Eine oder mehrere Umsteigerouten mit Zwischenstationen und Anschlusszeiten
Überprüfen Sie die Verfügbarkeit auf jeder Etappe

Überprüfen Sie am 15. März die Ticketverfügbarkeit für jeden Abschnitt der empfohlenen Route.✓ Kopiert

→ Sitzplatzverfügbarkeit für beide Reiseabschnitte

Ergebnis: Eine vollständige Reiseroute mit mehreren Etappen und bestätigter Verfügbarkeit.

Fallstricke

Enge Transferfenster können dazu führen, dass Verbindungen verpasst werden — Bitten Sie Claude, nach Transfers mit mindestens 2 Stunden Abstand zwischen den Zügen zu filtern

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

12306-mcp-2 + fetch

Kombinieren Sie die Zugsuche mit Webabruf, um vor der Buchung das Wetter an Ihrem Zielort zu prüfen

Besorgen Sie mir für diesen Samstag einen Zug von Shanghai nach Hangzhou und schauen Sie sich die Wochenendwettervorhersage für Hangzhou an.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
query_tickets	from: str, to: str, date: str	Suchen Sie nach verfügbaren Bahntickets zwischen zwei Bahnhöfen	1 API call
search_stations	keyword: str	Suchen Sie nach Schlüsselwörtern nach Stationsnamen und -codes	1 API call
query_transfer	from: str, to: str, date: str	Finden Sie Umsteigerouten, wenn kein direkter Zug vorhanden ist	1 API call
get_train_route_stations	train_no: str	Erhalten Sie alle Haltestellen entlang der Strecke eines bestimmten Zuges	1 API call

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Hängt von 12306 öffentlichen API-Ratenbegrenzungen ab – normalerweise ausreichend für den persönlichen Gebrauch
Tokens pro Aufruf: 200–800 Token pro Abfrage
Kosten in €: Kostenlos – fragt die öffentliche 12306-API ab
Tipp: Batch-Stationssuche vor dem Ausführen von Ticketabfragen, um redundante Anrufe zu vermeiden.

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: Keine Anmeldeinformationen erforderlich – verwendet öffentliche 12306-API-Endpunkte

Datenabfluss: Alle Aufrufe gehen an die offiziellen API-Endpunkte von 12306.cn

Fehlerbehebung

Häufige Fehler und Lösungen

Station name not found

Verwenden Sie die Stationssuchfunktion, um den genauen Namen zu finden. Chinesische Stationsnamen müssen mit der Datenbank 12306 übereinstimmen – versuchen Sie es mit vereinfachtem Chinesisch und Pinyin.

Prüfen: Search for the station by keyword first

No trains found for the given date

12306 verkauft Tickets nur 15 Tage im Voraus. Stellen Sie sicher, dass Ihr Datum innerhalb des Buchungsfensters liegt.

Prüfen: Try a date within the next 15 days

Connection timeout

Die 12306-API kann zu Spitzenbuchungszeiten (z. B. Frühlingsfest) langsam sein. Versuchen Sie es nach ein paar Minuten noch einmal.

Prüfen: Test with a simple station search to confirm connectivity

Alternativen

12306-mcp vs. andere

Alternative	Wann stattdessen	Kompromiss
mcp-server-12306	Sie möchten eine Python-basierte Alternative mit FastAPI-Backend und zusätzlichen Preisabfragetools	Weitere Funktionen (Preisabfragen, HTTP-Streaming), erfordert jedoch die Einrichtung von Python/UV

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen