Zugauskunfts-MCP-Server (FastMCP)

Ein mit FastMCP umgesetzter Service zur Abfrage von Zug-/Hochgeschwindigkeitszugverbindungen, der als entferntes MCP-Tool von beliebigen Agenten (z. B. deepagents, LangGraph, Claude) aufgerufen werden kann.

Funktion

Eine Werkzeugfunktion: query_train_tickets(from_station, to_station, date)

• Abfrage der Verbindungen, Abfahrtszeiten, Fahrzeiten, Buchbarkeitsstatus und Sitzplatzverfügbarkeit zwischen zwei Bahnhöfen an einem bestimmten Tag

• Datenquelle: Öffentliche Abfrageschnittstelle von 12306 (echte Daten); bei Risikobegrenzung durch die Schnittstelle wird automatisch auf Simulationsdaten umgeschaltet und die Quelle klar gekennzeichnet, sodass die Kette jederzeit demonstrierbar ist

Related MCP server: THSRC MCP Server

Lokale Ausführung

pip install -r requirements.txt
python server.py        # 启动 streamable-http 服务，默认 http://127.0.0.1:8000

MCP-Client-Konfiguration (lokale Abstimmung):

{
  "mcpServers": {
    "train": {
      "url": "http://127.0.0.1:8000/mcp/",
      "transport": "streamable_http"
    }
  }
}

Bereitstellung auf dem ModellMCP-Platz (wichtige Schritte)

1. Dieses Repository auf GitHub pushen

2. modelscope.cn/mcp öffnen → Anmelden → „MCP erstellen“ klicken

3. Erstellungstyp „Schnellerstellung über GitHub“ wählen; Hosting-Typ „Hosting bereitstellbar“ wählen

4. Englischen/chinesischen Namen und Quelladresse (GitHub-Repository-URL) eingeben, Konfiguration gemäß den Plattformhinweisen ergänzen

5. Nach dem Absenden generiert die Plattform eine Zugriffsadresse: https://mcp.api-inference.modelscope.net/<deine-ID>/sse oder /mcp (kann dauerhaft gültig gesetzt werden)

6. Diese Adresse in der MCP-Konfiguration des Agentenprojekts eintragen

Hinweis: Die Plattform hat Anforderungen an die Startmethode des gehosteten Projekts (in der Regel Python + Start eines HTTP-Dienstes). Bei Bereitstellungsfehlern den Einstiegspunkt gemäß den Plattformhinweisen anpassen (z. B. durch Bereitstellen eines run-Skripts oder einer Umgebungsvariable).

Erläuterung der Datenquelle

• 12306 bietet keine offizielle offene API an. Dieses Projekt verwendet deren öffentliche Abfrageschnittstelle (kyfw.12306.cn/otn/leftTicket), die ohne Anmeldung abfragbar ist, ausschließlich für persönliches Lernen und Studium

• Die Schnittstelle unterliegt einer Risikobegrenzung (gelegentlich 302). Der Code enthält bereits Sitzungs-Cookies + Simulationsdaten als Ausweichlösung

• Für stabilere Daten kann _fetch_12306 durch eine Drittanbieter-Datenquelle ersetzt werden (austauschbar)

Verzeichnis

• server.py — Hauptprogramm des FastMCP-Dienstes

• test_client.py — Lokales Abstimmungsskript (direkter Aufruf der Werkzeugfunktion + Test über das MCP-Protokoll)

• requirements.txt — Abhängigkeiten