trucksim-mcp

Сервер MCP, передающий телеметрию Euro Truck Simulator 2 и American Truck Simulator — плюс аналитику вождения в реальном времени — в любую ИИ-среду (Claude Desktop, Claude Code, Cursor, Cline, …). Включает фоновый аналитический агент Claude, который выполняет роль бортового диспетчера и инструктора по вождению.

Спросите своего ассистента: «Я превышаю скорость?», «Успею ли я к сроку доставки?», «Какой у меня запас топлива?» или «Оцени моё вождение на данный момент» — и он ответит на основе живой телеметрии игры. Это сервер только для чтения: телеметрия и аналитика, он никогда не управляет грузовиком.

Примечание: «American Truck Simulator 2» — это не отдельная игра: SCS по-прежнему выпускает оригинальный ATS. И ATS, и ETS2 используют один и тот же движок и SDK телеметрии, поэтому trucksim-mcp поддерживает обе игры без настройки.

Как это работает

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

Поскольку SDK SCS записывает данные в общую память Windows, trucksim-mcp считывает телеметрию через подключаемый источник:

Источник mock означает, что весь конвейер можно прогнать от начала до конца на любой ОС без установленной игры.

Быстрый старт

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

Конфигурацию для Claude Desktop / Cursor / Cline установите в docs/clients.md, а подключение реальной телеметрии ETS2/ATS — в docs/sources.md.

Подключение локальных ETS2 / ATS

Источнику mock игра не нужна. Чтобы считывать данные реальной игры, выберите источник (полный гайд — в docs/sources.md):

Кроссплатформенный способ (рекомендуется) — игра запущена на Windows, а trucksim-mcp может работать где угодно в вашей локальной сети:

1. Установите плагин телеметрии SCS (sona/SDK) в папку игры bin/win_x64/plugins/.

2. Установите HTTP-сервер телеметрии (Funbit/ets2-telemetry-server).

3. Настройте и проверьте подключение до того, как подключить 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 — trucksim-mcp на том же ПК, где запущена игра: задайте TRUCKSIM_SOURCE=mmap (экспериментально) и выполните trucksim-mcp selftest.

Используйте же переменные окружения в конфигурации MCP-клиента или в agent/mcp.json.

Инструменты

10 инструментов только для чтения — полная документация в инструменты:

• Состояние — get_truck_state, get_navigation, get_fuel_status, get_raw_telemetry

• Рейс — get_active_job

• Аналитика — check_speeding, get_eco_score, get_trip_summary, get_rest_advisor, list_recent_events

Примеры запросов

После подключения (даже с TRUCKSIM_SOURCE=mock) спросите своего ассистента:

• «Что делает мой грузовик прямо сейчас?» → get_truck_state

• «Я превышаю скорость?» → check_speeding

• «Хватит ли мне топлива, чтобы добраться до пункта назначения?» → get_fuel_status

• «Успею ли я в срок доставки?» → get_active_job

• «Оцени моё вождение и подскажи, что исправить.» → get_eco_score + get_trip_summary

• «Не пора ли мне сделать перерыв?» → get_rest_advisor

Инструкторагент в действии

Запуск фонового агента на встроенном mock-маршруте — реальный процесс claude -p (Sonnet 5) считывает телеметрию через этот сервер:

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

Фоновый аналитический агент

Каталог /agent содержит фоновую версию Claude Code headless (claude -p, Sonnet 5), которая подключается к этому MCP-серверу и создаёт периодические советы водителю по живой телеметрическим данным — диспетчер без голоса. См. agent/README.md.

Лицензия

MIT © Rachitt Shah. Проект не аффилирован с SCS Software и не одобрен ею. Euro Truck Simulator 2 и American Truck Simulator являются товарными знаками SCS Software.