trucksim-mcp

Un servidor MCP que transmite la telemetría de Euro Truck Simulator 2 y American Truck Simulator — además de análisis de conducción en vivo — para cualquier cliente de IA (Claude Desktop, Claude Code, Cursor, Cline, …). Incluye un agente de análisis Claude sin interfaz que actúa como despachador en cabina y entrenador de conducción.

Pregunta a tu asistente "¿Estoy excediendo el límite de velocidad?", "¿Cumpliré el plazo de entrega?", "¿Cuál es mi autonomía de combustible?" o "Evalúa mi conducción hasta ahora" — y te responde con la telemetría del juego en vivo. Este es un servidor solo lectura, de telemetría y análisis: nunca controla el camión.

Nota: «American Truck Simulator 2» no es un juego aparte: SCS sigue publicando el ATS original. Tanto ATS como ETS2 comparten el mismo motor y el mismo SDK de telemetría, así que trucksim-mcp es compatible con ambos sin configuración.

Cómo funciona

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

Como el SDK de SCS escribe en la memoria compartida de Windows, trucksim-mcp lee la telemetría a través de una fuente conectable:

La fuente mock significa que todo el flujo funciona de extremo a extremo en cualquier sistema operativo sin tener el juego.

Inicio rápido

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

Consulta docs/clients.md para la configuración de Claude Desktop / Cursor / Cline, y docs/sources.md para conectar la telemetría real de ETS2/el ATS.

Conecta tu ETS2 / ATS local

La fuente mock no necesita el juego; para leer tu juego real, elige una fuente (docs/sources.md tiene la guía completa):

Multiplataforma (recomendado) — el juego se ejecuta en Windows, trucksim-mcp puede ejecutarse en cualquier lugar de tu red:

1. Instala el plugin de telemetría de SCS (RenCloudSCS-sdk-plugin) en el directorio bin/win_x64/plugins/ del juego.

2. Ejecuta un servidor HTTP de telemetría (Funbit/ets2-telemetry-server, puerto 25555).

3. Configura y verifica la conexión antes de abrir un cliente MCP:

   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.

Windows nativo — trucksim-mcp en el mismo PC que el juego: define TRUCKSOITMMAP=mmap (experimental) y ejecuta trucksim-mcp selftest.

Luego usa las mismas variables de entorno en la configuración de tu cliente MCP o en agent/mcp.json.

Herramientas

10 herramientas de solo lectura: consulta la referencia completa en docs/herramientas.md:

• Estado — get_truck_state, get_navigation, get_fuel_status, get_raw_telemetry

• Trabajo — get_active_job

• Análisis — get_speeding, get_eco_score, get_trip_summary, get_rest_advisor, list_recent_events

Preguntas de ejemplo

Once conectado (incluso con TRUCKSIM_SOURCE=mock), pregunta a tu asistente:

• "¿Qué está haciendo mi camión ahora mismo?" → get_truck_state

• "¿Estoy excediendo el límite de velocidad?" → check_speeding

• "¿Tengo combustible suficiente para llegar al destino?" → get_fuel_status

• "¿Llegaré a tiempo de la entrega?" → get_active_job

• "Evalúa mi conducción y dime qué corregir." → get_eco_score + get_trip_summary

• "¿Debería tomarme un descanso?" → get_rest_advisor

El agente entrenador en acción

Al ejecutar el agente headless contra el viaje simulado integrado — un real claude -p (Sonnet 5) que lee la telemetría a través de este servidor:

$ 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.

El agente analítico headless

agent/ contiene un runner en segundo plano Claude Code headless (claude -p, Sonnet 5) que se conecta a este servidor MCP y genera actualizaciones periódicas de coaching en cabina a partir de la telemetría en vivo — un despachador sin voz. Ver aquí: agent/README.md.

Licencia

MIT © Rachitt Shah. No afiliado ni patrocinado por SCS Software. Euro Truck Simulator 2 y American Truck Simulator son marcas comerciales de SCS Software.