mcp-server-12306 — Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

7 MCP-Tools für Tickets, Preise, Bahnhöfe, Routen und Transfers
Smart station search supporting Chinese characters, pinyin, and abbreviations
Real-time fare information for specific trains and seat classes
Dual protocol: stdio for Claude Desktop, Streamable HTTP for remote deployment
FastAPI-based with sub-second response times

Live-Demo

In der Praxis

mcp-server-12306-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": {
    "mcp-server-12306-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/drfccv/mcp-server-12306"
      ]
    }
  }
}

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

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

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

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

VS Code → Cline → MCP Servers → Edit

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

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

~/.codeium/windsurf/mcp_config.json

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

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

~/.continue/config.json

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

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

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

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

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

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

Anwendungsfälle

Praxisnahe Nutzung: mcp-server-12306

How to compare train ticket prices for a journey with mcp-server-12306

👤 Budget-conscious travelers in China ⏱ ~5 min beginner

Wann einsetzen: You want to find the cheapest option for your train journey.

Voraussetzungen

mcp-server-12306 running — uvx mcp-server-12306 or Docker: docker run -p 8000:8000 drfccv/mcp-server-12306:latest

Ablauf

Suchen Sie nach Tickets mit Preisen

Fragen Sie nach Tickets von Peking nach Guangzhou für morgen. Zeigen Sie alle verfügbaren Züge mit Preisen für jede Sitzklasse an.✓ Kopiert

→ Zugtabelle mit Abfahrtszeiten, Dauer und Preisen pro Sitzplatzklasse
Erhalten Sie detaillierte Preise

Zeigen Sie mir die detaillierten Preise für den Zug G79, einschließlich aller Sitzplatztypen.✓ Kopiert

→ Vollständige Preisaufschlüsselung für den jeweiligen Zug

Ergebnis: Clear price comparison to choose the best value train.

Fallstricke

Die Preise können je nach Datum und Verfügbarkeit variieren — Überprüfen Sie die Verfügbarkeit und die Preise – günstige Sitzplätze sind zuerst ausverkauft

Planen Sie eine Zugreise durch mehrere Städte Chinas

👤 Touristen planen eine malerische Route durch mehrere chinesische Städte ⏱ ~15 min beginner

Wann einsetzen: Sie möchten mehrere Städte besuchen und müssen die Zugverbindungen planen.

Voraussetzungen

mcp-server-12306 läuft — uvx mcp-server-12306

Ablauf

Sender suchen

Suchen Sie nach den wichtigsten Bahnhöfen in Shanghai, Hangzhou und Suzhou. Zeigen Sie mir die Stationscodes.✓ Kopiert

→ Stationsnamen und Codes für jede Stadt
Planen Sie die Route

Finden Sie die schnellsten Zugverbindungen für: Shanghai → Hangzhou → Suzhou → zurück nach Shanghai, wobei Sie in jeder Stadt einen Tag verbringen. Abfahrtszeiten und -dauer anzeigen.✓ Kopiert

→ Vollständiger Reiseplan mit Zugnummern und -zeiten

Ergebnis: Eine Reiseroute durch mehrere Städte mit allen geplanten Zugverbindungen.

Fallstricke

Kleine Städte dürfen nur einen Bahnhof haben — Nutzen Sie die Sendersuche, um verfügbare Sender vor der Planung zu bestätigen

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

mcp-server-12306-2 + fetch

Überprüfen Sie neben den Zugfahrplänen auch das Wetter an Ihrem Zielort

Finden Sie dieses Wochenende Züge von Peking nach Chengdu und prüfen Sie die Wettervorhersage für Chengdu.✓ 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	1 API call
query_ticket_price	train_no: str, from: str, to: str, date: str	Erhalten Sie detaillierte Preise für einen bestimmten Zug	1 API call
search_stations	keyword: str	Suchen Sie Sender nach Namen, Pinyin oder Abkürzung	1 API call
get_station_info	station_code: str	Erhalten Sie detaillierte Stationsmetadaten	1 API call
query_transfer	from: str, to: str, date: str	Finden Sie optimale Transferrouten	1 API call
get_train_route_stations	train_no: str	Erhalten Sie alle Haltestellen entlang einer Zugstrecke	1 API call
get_current_time	none	Erhalten Sie die aktuelle Uhrzeit für relative Datumsberechnungen	0

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Vorbehaltlich der Ratenbegrenzungen der öffentlichen API 12306
Tokens pro Aufruf: 200–800 Token pro Abfrage
Kosten in €: Kostenlos – verwendet die öffentliche 12306-API
Tipp: Nutzen Sie die Stationssuche, um Namen zu bestätigen, bevor Sie Tickets abfragen, um unnötige Anrufe zu vermeiden.

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: Keine Anmeldeinformationen erforderlich

Datenabfluss: Alle Aufrufe an die offizielle API 12306.cn

Fehlerbehebung

Häufige Fehler und Lösungen

No tickets found

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

Prüfen: Try today's date to confirm connectivity

Station not recognized

Verwenden Sie zuerst „search_stations“ mit Pinyin oder Chinesisch, um den genauen Sendernamen zu finden.

Prüfen: search_stations with a broader keyword

Timeout during peak hours

12306 API ist während der Hauptverkaufszeit (Feiertage, Frühlingsfest) langsam. Versuchen Sie es nach ein paar Minuten noch einmal.

Prüfen: Test with a simple station search

Alternativen

mcp-server-12306 vs. andere

Alternative	Wann stattdessen	Kompromiss
12306-mcp	Sie bevorzugen einen JavaScript/npx-basierten Server mit einfacherer Einrichtung	Einfachere Installation, aber weniger Funktionen (keine Preisabfragen oder HTTP-Streaming)

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen