trucksim-mcp

Ein MCP-Server, der Telemetriedaten von Euro Truck Simulator 2 und American Truck Simulator – zusätzlich Live-Fahr-Analysen – an beliebige KI-Clients streamt (Claude Desktop, Claude Code, Cursor, Cline, …). Enthalten ist außerdem ein headless Claude-Analytics-Agent, der als Dispatcher/Fahrcoach im Fahrerhaus agiert.

Frag deinen Assistenten „Fahre ich zu schnell?", „Schaffe ich die Lieferfrist?", „Wie viel Reichweite habe ich noch?" oder „Bewerte mein bisheriges Fahrverhalten" – und er antwortet anhand der Live-Telemetriedaten. Das ist ein schreibgeschützter, telemetrie- und analysen-basierter Server: Er übernimmt niemals die Steuerung des Lkw.

Hinweis: „American Truck Simulator 2" ist kein separates Spiel – SCS liefert weiterhin das ursprüngliche ATS aus. ATS und ETS2 teilen sich dieselbe Engine und dasselbe Telemetrie-SDK, daher unterstützt trucksim-mcp beide ohne Konfiguration.

So funktioniert es

ETS2 / ATS ──(SCS Telemetry SDK)──▶ telemetry source ──▶ trucksim-mcp ──▶ any MCP client
                                     (mmap | http | mock)   (tools+analytics)   (Claude, Cursor…)

Da das SCS SDK in den Windows-Shared-Memory schreibt, liest trucksim-mcp Telemetriedaten über eine austauschbare Quelle:

Die mock-Quelle bedeutet, dass die gesamte Pipeline auf jedem Betriebssystem by end-to-end läuft – ohne installiertes Spiel.

Schnellstart

# no install, straight from GitHub (PyPI release pending)
TRUCKSIM_SOURCE=mock uvx --from git+https://github.com/rachittshah/trucksim-mcp trucksim-mcp

Weitere Anleitungen findest du in docs/clients.md für die Claude-Desktop-/Cursor-/Cline-Konfiguration und in docs/it-sources.md für die Anbindung echter ETS2/ATS-Telemetriedaten.

Lokales ETS2 / ATS verbinden

Die mock-Quelle benötigt kein Spiel; um dein echtes Spiel einzulesen, wähle eine Quelle (docs/sources.md enthält die vollständige Anleitung):

Plattformunabhängig (empfohlen) – das Spiel läuft auf Windows, trucksim-MCP kann überall in deinem LAN laufen:

1. Installiere das SCS-Telemetrie-Plugin (RenCloud/scs-sdk-plugin) in das Verzeichnis bin/win_64/plugins/ deines Spiels.

2. Starte einen Telemetrie-HTTP-Server (Funbit/ets2-telemetry-server, Port 25555).

3. Richte alles ein und prere. die Verbindung, bevor du einen MCP-Client anschließt:

   export TRUCKSIM_SOURCE=http
   export TRUCKSIM_HTTP_URL=http://<game-pc-ip>:25555/api/ets2/telemetry
   uvx --from git+https://github.com/rachittshah/trucksim-mcp trucksim-mcp selftest

   source: http
   connected: True
   game:   ets2
   speed:  84 km/h (limit 90)
   job:    Reefer  Frankfurt -> Munich
   ✅ Telemetry is live. Point your MCP client at this same config.

Natives Windows – trucksim-mcp auf demselben PC wie das Spiel: setze TRUCKSIM_SOURCE=mmap (experimentell) und führe trucksim-mcp selftest aus.

Verwende danach dieselben Umgebungsvariablen in der Konfiguration deines MCP-Clients oder in agent/mcp.json.

Tools

10 schreibgeschützte Tools – dir die vollständige Referenz in docs/tools.md:

• Status – get_truck_state, get_navigation, get_fuel_status, get_raw_telemetry

• Auftrag – get_active_job

• Analysen – check_speeding, get_eco_score, get_trip_summary, get_rest_advisor, list_recent_events

Beispiel-Prompts

Sobald du verbunden bist (auch mit TRUCKSIM_SOURCE=mock), frag deinen Assistant:

• „Was macht mein Lkw gerade?" → get_truck_state

• „Fahre ich zu schnell?" → check_speeding

• „Habe ich genug Kraftstoff, um das Ziel zu erreichen?" → get_fuel_status

• „Schaffe ich die Lieferfrist?" → get_active_job

• „Bewerte mein Fahrverhalten und sage mir, was ich verbessern soll." → get_eco_score + get_trip_summary

• „Sollte ich eine Pause machen?" → get_rest_advisor

Der Coaching-Agent in Aktion

Lässt man den headless-Agent gegen die eingebaute Mock-Fahrt laufen – ein echtes claude -p (Sonnet 5), das die Telemetrie über diesen Server liest:

$ TRUCKSIM_AGENT_ONCE=1 ./agent/coach.sh

Heads up: your Hamburg steel-tubes job is projected LATE — ETA 7h7m vs a 4h59m
deadline, a 2h7m shortfall, so this delivery needs a route/time fix, not just
steady driving. Speed and fuel are fine: you're well under the 90 km/h limit,
damage is only 3%, and fuel (688L, ~2149 km range) easily covers the 285 km
trip. Recommendation: check for a faster route or accept the late penalty now.

Der headless-Analyse-Agent

agent/ enthält einen Hintergrund-Runner für headless Claude Code (claude -p, Sonnet 5), der sich mit diesem MCP-Server verbindet und aus Live-Telemetriedaten regelmäßige Coaching-Updates für das Fahrerhaus erzeugt – ein Dispatcher ohne Stimme. Details in agent/README.md.

Lizenz

MIT © Rachitt Shah. Nicht mit SCS Software verbunden oder von SCS Software gesponsert. Euro Truck Simulator 2 und American Truck Simulator sind Marken von SCS Software.