ac-race-engineer

MCP server, der Claude in einen Renn-Ingenieur für das originale Assetto Corsa verwandelt. Er liest AC's Shared Memory Telemetrie, speichert Runden in SQLite, reduziert sie zu Zusammenfassungen auf Ingenieurniveau und kann Setup-Dateien lesen/schreiben, die direkt im Ingame-Setup-Menü erscheinen.

Läuft auf dem Windows-Rechner, der Assetto Corsa ausführt. Nur originales AC (verwendet das acpmf_* Shared Memory Layout, nicht ACC's).

Installation (Windows – der einfache Weg)

Voraussetzung: Python 3.10+ von python.org. Aktivieren Sie auf dem ersten Bildschirm des Installers "Add python.exe to PATH". Verwenden Sie nicht den Microsoft Store-Build – seine Sandboxing unterbricht den Shared-Memory-Zugriff.

Dann in diesem Ordner: Rechtsklick auf install-windows.bat → Öffnen (oder einfach doppelklicken).

Das war's. Der Installer findet Python, installiert das Paket, schreibt die Claude Desktop-Konfiguration (zusammengeführt mit allen vorhandenen MCP-Servern, nach einem Backup), findet Ihre Assetto Corsa-Installation und kopiert die Ingame-Lua-App an die richtige Stelle. Führen Sie es nach einem git pull erneut aus; es aktualisiert direkt.

Wenn er Assetto Corsa nicht finden kann, geben Sie an, wo es zu suchen ist. Flags werden auf die .bat gesetzt, nicht auf die .ps1 – Windows blockiert .ps1-Dateien unter der standardmäßigen Ausführungsrichtlinie, und die .bat existiert, um genau das zu umgehen:

install-windows.bat -AcPath "D:\Games\steamapps\common\assettocorsa"

Weitere Flags: -SkipLuaApp, -Uninstall.

Nach der Installation Claude Desktop vollständig beenden und erneut öffnen. Das Schließen des Fensters reicht nicht – klicken Sie mit der rechten Maustaste auf das Claude-Symbol in der Taskleiste (unten rechts, möglicherweise unter dem ^-Pfeil versteckt) und wählen Sie Beenden.

Related MCP server: fastf1-mcp-server

Installation (manuell)

python -m pip install -e .

Fügen Sie dann den Server zu claude_desktop_config.json hinzu. Der schnellste Weg, diese Datei zu öffnen, ist Claude Desktop → Settings → Developer → Edit Config, was sie erstellt, falls sie fehlt, und den enthaltenden Ordner öffnet – keine Dateisystem-Archäologie erforderlich.

%APPDATA% ist eine Umgebungsvariable, kein wörtlicher Pfad. Sie wird zu C:\\Users\\<you>\\AppData\\Roaming expandiert – und AppData ist ein versteckter Ordner, sodass das Durchsuchen im Explorer nichts anzeigt, es sei denn, Sie aktivieren Ansicht → Ausgeblendete Elemente.

Die größere Falle: %VAR% ist cmd.exe-Syntax. Windows Terminal verwendet standardmäßig PowerShell, wo dieselbe Variable als $env:VAR geschrieben wird. Also:

Um den Ordner statt der Datei zu öffnen, verwenden Sie explorer $env:APPDATA\\Claude in PowerShell.

{
  "mcpServers": {
    "ac-race-engineer": {
      "command": "C:\\Users\\<you>\\AppData\\Local\\Programs\\Python\\Python312\\python.exe",
      "args": ["-m", "ac_race_engineer.server"]
    }
  }
}

Verwenden Sie den absoluten Pfad zu python.exe, nicht das bloße "python". Claude Desktop startet MCP-Server ohne das PATH Ihrer Shell, daher schlägt ein bloßer Befehl häufig stillschweigend fehl. Erhalten Sie den korrekten Pfad mit:

py -c "import sys; print(sys.executable)"

Verwenden Sie nicht (Get-Command python).Source – unter Standard-Windows gibt das oft ...\\WindowsApps\\python.exe zurück, den Microsoft Store-Alias-Stub, was die falsche Antwort ist. Denken Sie daran, dass JSON doppelte Backslashes benötigt (\\\\).

(Falls Sie stattdessen Claude Code verwenden: claude mcp add ac-race-engineer -- python -m ac_race_engineer.server)

Optionale Umgebungsüberschreibungen:

• AC_DOCS_DIR — AC-Dokumentenordner (Standard ~/Documents/Assetto Corsa)

• AC_ENGINEER_DATA — DB + Bereiche-Speicherort (Standard ~/.ac-race-engineer)

• AC_ENGINEER_BRIDGE_PORT — Ingame-App-Bridge-Port (Standard 9666)

Fehlerbehebung

Claude listet die Tools nicht auf. Stellen Sie sicher, dass Sie Claude Desktop vollständig beendet und wieder geöffnet haben (Taskleistensymbol → Beenden). Lesen Sie dann das Serverprotokoll:

notepad $env:APPDATA\Claude\logs\mcp-server-ac-race-engineer.log

Die Eingabe von python öffnet den Microsoft Store (oder sagt "not recognized"). Windows enthält einen App-Ausführungsalias-Stub unter %LOCALAPPDATA%\\Microsoft\\WindowsApps\\python.exe, der den Namen kapert, wenn kein echtes Python im PATH ist. Installieren Sie Python von python.org mit aktiviertem "Add python.exe to PATH" oder verwenden Sie den py-Launcher (py -3 -m pip install -e .) – der python.org-Installer richtet das standardmäßig ein. Sie können den Stub auch deaktivieren unter Einstellungen → Apps → Erweiterte App-Einstellungen → App-Ausführungsaliase.

Der Installer ignoriert bereits alles unter WindowsApps, das betrifft Sie also nur bei einer manuellen Installation.

.ps1 cannot be loaded because running scripts is disabled. Das liegt an der Ausführungsrichtlinie. Verwenden Sie stattdessen install-windows.bat – es umgeht die Richtlinie für dieses eine Skript, ohne eine Systemeinstellung zu ändern.

Setup-Werte bleiben im Spiel nicht erhalten. Sie schreiben außerhalb des legalen Bereichs des Autos und AC ignoriert sie stillschweigend – siehe nächster Abschnitt.

Der Abstimmungszyklus

1. Starten Sie AC, gehen Sie auf die Strecke.

2. Sagen Sie Claude: "start recording and confirm you can see the session" (start_recording, live_snapshot).

3. Fahren Sie 3–5 Runden. Runden werden automatisch gespeichert, sobald sie abgeschlossen sind; Ausflüge außerhalb der Strecke (>2 Reifen draußen) markieren eine Runde als ungültig.

4. "Summarize my last lap and read my current setup" (list_laps, lap_summary, read_setup). Die Zusammenfassung enthält pro Kurve die Mindestgeschwindigkeit, Bremspunkte, Reifendrücke/-temperaturen und eine Schlupf-Balance-Metrik (positiv = Untersteuern, negativ = Übersteuern).

5. Besprechen Sie, was das Auto macht; Claude schreibt ein überarbeitetes Setup mit write_setup (z.B. als claude_v1).

6. Boxenstopp, laden Sie claude_v1 aus dem Setup-Bildschirm, fahren Sie erneut.

7. "Compare my best lap on the new setup against lap N" (compare_laps) – Kurvenweise Mindestgeschwindigkeits- und Bremspunkt-Deltas zeigen, ob die Änderung tatsächlich funktioniert hat.

Setup-Wert-Begrenzung (empfohlen)

AC ignoriert stillschweigend Setup-Werte außerhalb der im setup.ini des Autos definierten Bereiche (innerhalb von data.acd). Damit der Server Werte auf die legalen Min/Max/Schritte jedes Autos begrenzt und einrastet:

1. In Content Manager: Autoseite → Daten entpacken (oder QuickBMS verwenden).

2. Kopieren Sie die setup.ini des Autos in den ranges-Ordner, benannt nach dem Ordnernamen des Autos – z.B. ks_mazda_mx5_cup.ini.

Um diesen Ordner zu öffnen (der Installer hat ihn bereits erstellt):

explorer $env:USERPROFILE\.ac-race-engineer\ranges

(cmd.exe: explorer %USERPROFILE%\.ac-race-engineer\ranges)

Ohne eine ranges-Datei funktionieren Schreibvorgänge trotzdem, geben aber eine Warnung zurück, und Sie sollten die Werte im Setup-Bildschirm auf Plausibilität prüfen.

Ingame-App (CSP Lua)

install-windows.bat kopiert dies für Sie. Um es von Hand zu machen, kopieren Sie lua_app/race_engineer/ nach assettocorsa/apps/lua/race_engineer/ (erfordert Custom Shaders Patch; Sie haben es bereits, wenn Sie Content Manager mit aktiviertem CSP verwenden). Aktivieren Sie es über die Ingame-Apps-Seitenleiste – bewegen Sie die Maus während einer Sitzung an den rechten Bildschirmrand.

Nicht sicher, wo Assetto Corsa installiert ist? In Steam, Rechtsklick auf Assetto Corsa → Manage → Browse local files.

Was es tut:

• Beschwerde-Tags während der Fahrt — Understeer / Oversteer / Braking / Traction-Buttons, jeweils über das Einstellungsfenster der App an eine Lenkradtaste bindbar (sie erscheinen als CSP-Steuerungsbindungen). Das Drücken eines zeichnet Ihre genaue Spline-Position, Runde und Geschwindigkeit auf. Claude liest sie mit get_driver_notes und korreliert sie mit der Kurventelemetrie: "you flagged understeer twice at spline 0.34 — that's the corner where front slip exceeds rear by 0.09".

• Status-Overlay — Aufnahmeindikator + gespeicherte Runden, damit Sie nie alt-tabben müssen, um nachzusehen.

• Nachrichten von Claude — send_driver_message legt eine Notiz auf das Overlay ("claude_v2 saved — pit and load it"); mit OK schließen.

Die App kommuniziert mit der HTTP-Bridge des Servers auf 127.0.0.1:9666 (ändern mit AC_ENGINEER_BRIDGE_PORT, und bearbeiten Sie BASE im Lua-Code entsprechend). Die Bridge bindet nur localhost.

Struktur

ac_race_engineer/
  sim_info.py   shared memory structs (physics / graphics / static)
  collector.py  background sampler -> SQLite, lap boundary detection
  db.py         schema + storage
  analysis.py   corner detection, lap summaries, lap comparison
  setups.py     setup INI read/write, range clamping
  bridge.py     localhost HTTP bridge for the in-game app
  server.py     MCP tools
lua_app/
  race_engineer/  CSP Lua in-game app (copy to apps/lua/)
install-windows.ps1  one-shot Windows installer
install-windows.bat  double-clickable wrapper for the above

Anmerkungen / zukünftige Ideen

• Die Abtastrate beträgt 25 Hz – ausreichend für Setup-Arbeiten, während die DB klein bleibt. Erhöhen Sie TARGET_HZ in collector.py, wenn Sie feinere Spuren wünschen.

• Auslaufrunden (keine gültige Zeit) werden automatisch übersprungen.

• Die Kurvenerkennung ist generisch (Geschwindigkeitsminima); eine streckenspezifische Kurvennamenkarte würde Claudes Ratschlage angenehmer lesbar machen ("T3/Variante" vs "corner at 0.34").

• CSP/Lua könnte Dämpfergeschwindigkeiten und mehr Kanäle als der Standard-Shared-Memory bereitstellen, falls Sie jemals tiefere Federungsarbeit wünschen – Telemetrick's Quellcode ist eine gute Referenz.