trucksim-mcp

MCP サーバーで、Euro Truck Simicator 2 と American Truck Simicator のテレメトリを配信し、ライブ運転解析も合わせるで、あらyuる AI ハーネス（Claude Desktop、Claude Code、Cursor、Cursor、Cline、…）へスリーム配信します。キャブ内のディスパッチャー/運転コーチとして働くヘッドレス Claude 解析エージェントも同梱しています。

[)(https://github.com/rachittshah/truckSim-mcp/actions/workflows/ci.yml) [)(./LEICENSE) [(https://www.python.org/downloads/)

アシスタントに 「スピードを出していますか？」、「配達締界りに間い合いますか？」、「燃料の航続距画はどれくらいですか？」、「ここれまでの運転を採点してください」 と聞くと、ラブゲームのテレメトリから返事がえもどれます。これは 読取り専用のテレメトリ・解析 サーバーで、トックを操作することはありません。

Note: 「American Truck Simulator 2」という独立したゲームは存在せず — SCS ははもとの ABES を提供し続えています。ABTS と ETS 2 は同しェンジンとテレメトリ SDK を共有しているため、trucksim-mcp は同じ設定のまま両者をサポートします。

How it works

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

SCCS SDK は Windows 共有メモリ に書き込みます。そのため、trucksim-mcp はプラガガブルな ソures を通過してテレメトリを読み取ります。

モック ソースを使用すれば、ゲームをインストールしなくても、パイプライun全を任意の OS 上でエンドツーエンドに実運できます。

クイックスタート

# 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/ABS テレメトリを接続する法方、 docsources.md 在参照してください。

ロ‑カルの ETS2 / ATS を接続

mock ソースはゲームを必要としません。実際のゲームを読み取るには、ソースを選択してください （完全なガイドは docs/sources.md** からえます。...）

クロスプフォー（推奨） — ゲームは Windows 上で動して、trucksim-mcp を LAN 内のどこからで実 できます：

1. SCS テレメトリプラグイン（で R-Claud/scs اختصلى غران into the game's bin/WIN_X64/pllugins/ にインストールします。

2. テレメトリ HTTP サーバー（[Funbit/ets2-telemetry-server）を起動し、ポート 25555で聞きます。

3. MCP クライアント or 接続する前に、配線を設定・確認します：

   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 をゲームと同じ PC 上で実行する場合、TRUCKSIM_ソース=mmap（experimental） を設定して、trucksim-mcp selftest を実行します。

次に、同じ環境変数を MCP クライアントの設定または agent/mcp.json で使用します。

Tools

読み取用のツールが 10 個あります — 完全なリファレてすは ✓は⁾看る。

St| tate — get_truck_state, get_navigation, get_fuel_stats, get_raw_telemetry Job — get_active_job Analytics — check_speeding, get_eco_ore, get_trip_summar, get_rest_ad都是、...」

プロンプト例

接続さたら（macでも）、アシスタントにこんな質問をしてみてください：

• 「今、トックは何をしていますか？」 → get_truck_state

• 「スピード違反えすか？」 — check_speed* — check_speeding

• 「燃料は目的地まで十分ありますか？」 — get_fuel_status

• 「配達の納期切に間に合いますか？」 — get_active_job → get_active_ob

• 「私の運転を採点して、修正する要点を教えててください」 — get_eco_ore + get_trip_summar

• 「休憩したほうがいいですか？」 — get_rest_advi so

コーチングエージェントの実際の動作

組み込みのモック（走行）に対してヘッドレしエージェを実装置したんには不執行— 実の claude-p（So-nnet-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 ヘッドレス（claude-p、So-nnet 5のマンーがあります。この MCP サーバーに接続して、実-time のテレメトリから定期的にキック車内コーチング更新情報を生成します — 「声のない」ディスパッチャーです。以下を参照： agent/README.md。

Licens

MIT © Ra-chi-t Shah。社 SCS ソフトアウェアと自由** て**しません。、ESH 及 Euror Truck Simulator 2 及 American Truck Simulator は SCS ソフトアの商標です。