CarMaker

carmaker-mcp

AI エージェントがコンピューター上の IPG CarMaker を操作できる MCP サーバーです。セッションの開始、テストランの実行と結果の読み取り、車両データや Simulink コントローラーのパラメーターの変更、および変更内容の取り消しができます。

非公式のコミュニティプロジェクトであり、IPG Automotive または MathWorks とは提携しておらず、推奨も受けていません。CarMaker と MATLAB/Simulink のライセンスはご自身でご用意ください。このリポジトリには、IPG または MathWorks のコードやデータは含まれていません。

ステータス：アルファ版。 1 つの環境（CarMaker 14.1.1、MATLAB R2024b、Windows 11）で開発およびテストされています。 docs/verification.md では、実際のソフトウェアで確認済みの項目と未確認の項目を一覧にしています。

目次： できること · 対象外のこと · 要件 · セットアップ · MATLAB MCP サーバーとの併用 · 設定 · ツール · 安全性とプライバシー · トラブルシューティング · 仕組み

できること

サーバーに接続すると、エージェントに次のようなことを依頼できます。

• 「制動テストランを実行して、停止距離を教えてください。」
• 「コントローラーモデルの Kp_yaw を 1.5 に設定し、スラロームをもう一度実行してヨーレートを比較してください。」
• 「車両質量を 280、300、320 kg にしてレーンチェンジを試し、横加速度を表にまとめてください。」
• 「最後のランが中断されました。なぜですか？」
• 「変更した内容をすべて元に戻してください。」

このサーバーは 2 つの方法で動作し、エージェントは車両に適した方法を選びます。

具体的な使用例： docs/examples.md。

対応範囲外

このサーバーは、Formula Student チームでの車両ダイナミクスおよびコントローラー開発向けに作られており、各シミュレーションは単独実行か CarMaker for Simulink 実行のいずれかでした。CarMaker ではこれ以外にも多くのことができますが、以下はこのサーバーの対応範囲外であり、試験も行われていません。

非対応（対応するツールはありません）：

• その他のプラットフォームと製品： Linux、TruckMaker、MotorcycleMaker、CarMaker HIL、CarMaker Office Extended（リアルタイムハードウェア、Fail Safe Tester、CAN、FlexRay、SOME/IP、XCP などのバスインターフェース）。
• CarMaker 独自のテスト自動化： Test Manager、テストシリーズ、テストレポート、並列（HPC）実行、スタートアップファイルを使ったバッチモード。代わりに、このサーバーでは独自のパラメータスタディを実行し、シミュレーションを1回ずつ順番に処理します。
• シナリオの作成： Scenario Editor、道路、交通、センサー、環境、OpenSCENARIO のインポート。cm_edit は既存ファイルのキーを変更しますが、これらの要素を作成するものではありません。
• 大半の可視化機能： Movie NX、IPGControl、Instruments、動画のエクスポート、Model Check。IPGMovie では単一画像のみです。
• その他の結果形式： 読み込みに対応しているのは .erg ファイルのみで、MDF や ASCII には対応していません。
• シミュレーションプログラムの再ビルド： C コードのモデル、または Simulink Coder で生成されたモデル。
• リモートマシン： CarMaker と MATLAB は、サーバーを実行するコンピューター上で動作している必要があります。

動作する可能性はありますが、未試験です：

• FMU、FMU としてエクスポートされた CarMaker、サードパーティ製タイヤモデル、その他の協調シミュレーションツール。
• 暗号化または保護されたデータファイル。
• 上記以外のバージョンの CarMaker と MATLAB、複数の MATLAB セッションまたは CarMaker GUI の同時実行。
• 複数の単独実行の並列処理、単独実行の一時停止と再開、単独実行でのパラメータスタディ。
• 交通、センサー、運転支援機能を使用したテスト実行。これらを妨げる要因はありませんが、これまでの検証ではいずれも使用せずに車両ダイナミクスのシミュレーションを行っています。

各ツールの検証状況は docs/verification.mdに記載されています。 他の環境での報告も歓迎します。

要件

• Windows 10 または 11
• Python API を備えた IPG CarMaker（14.1.1 で開発）
• MATLAB 連携セッションの場合：CarMaker for Simulink と MATLAB R2022b 以降（使用する CarMaker が対応している範囲。［ステップ1］(#1-check-your-machine)の表を参照。試験済みなのは R2024b のみ）
• uv（サーバーとその Python 環境を取得します。pip も使用できます。詳しくは docs/setup.mdを参照してください）
• MCP クライアント：Claude Code、Claude Desktop、GitHub Copilot を備えた VS Code、Codex、Antigravity、Cursor など

セットアップ

1. マシンを確認する

uvx carmaker-mcp doctor

これにより、CarMaker と MATLAB のインストール状況を確認し、適合しない点とその修正方法を示して、使用しているマシンに合った uvx の引数を表示します。引数は次のようになります。

uvx --python 3.12 --with matlabengine==24.2.* carmaker-mcp

追加の引数が2つ必要です。そのため、ツールが適切な値を割り出します。

• --python 3.12 は、CarMaker と MATLAB のリリースの両方で動作する Python のバージョンを選択します。この指定がないと、uvx が両方で使えない新しい Python を選ぶ場合があります。
• --with "matlabengine==24.2.*" は、お使いの MATLAB リリース用の MATLAB エンジンパッケージを追加します。スタンドアロン実行のみを使用する場合は省略してください。

どちらも MATLAB のリリースによって異なります。MathWorks はリリースごとに1つのエンジンパッケージを公開しており、それぞれインストールできる Python のバージョンが限られているためです。

実際のソフトウェアで動作確認済みなのは R2024b の行のみです。それ以外は公開されているエンジンパッケージの要件に基づくもので、未テストです。報告をお待ちしています。MATLAB R2022a 以前は、エンジンパッケージがこのサーバーでサポートされているものより古い Python を必要とするため、MATLAB 接続セッションでは使用できません（スタンドアロン実行は引き続き動作します）。

CarMaker をインストールせずにツールを確認するには、次を実行してください。uvx carmaker-mcp --mock

2. MCP クライアントにサーバーを登録する

どのクライアントでも必要なものは同じです。コマンド uvx、手順 1 の引数、環境変数として設定する設定値です。通常、設定する値は次のとおりです。

• CM_PROJECT：CarMaker プロジェクトのフォルダーです。
• CM_MATLAB_INIT：通常、プロジェクトの MATLAB スクリプト（フォルダーをパスに追加してモデルを開くもの）を実行して作業を始める場合は、そのスクリプト名をここに指定すると、エージェントも実行します。
• CM_MODEL：セッション開始時にエージェントが開く Simulink モデルです。MATLAB のパス上の名前、またはプロジェクトの src_cm4sl フォルダーからの相対パスを指定します。省略すると、エージェントは見つかったモデルを提示し、その中から選ぶか、ユーザーに確認します。

以下からクライアントを選んでください。各例では MATLAB R2024b と Python 3.12 を想定しています。引数は doctor の出力に置き換えてください。または、シェルで設定されているすべての CM_ 変数を入力した状態で、サーバーにエントリーを書き込ませることもできます。

uvx carmaker-mcp config --client vscode     # or claude-code, claude-desktop, codex, antigravity, cursor

claude mcp add carmaker --env CM_PROJECT="C:\CM_Projects\my-project" --env CM_MODEL="MyModel" -- uvx --python 3.12 --with "matlabengine==24.2.*" carmaker-mcp

{
  "mcpServers": {
    "carmaker": {
      "command": "uvx",
      "args": ["--python", "3.12", "--with", "matlabengine==24.2.*", "carmaker-mcp"],
      "env": {
        "CM_PROJECT": "C:\\CM_Projects\\my-project",
        "CM_MODEL": "MyModel"
      }
    }
  }
}

{
  "servers": {
    "carmaker": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--python", "3.12", "--with", "matlabengine==24.2.*", "carmaker-mcp"],
      "env": {
        "CM_PROJECT": "C:\\CM_Projects\\my-project",
        "CM_MODEL": "MyModel"
      }
    }
  }
}

codex mcp add carmaker --env CM_PROJECT="C:\CM_Projects\my-project" --env CM_MODEL="MyModel" -- uvx --python 3.12 --with "matlabengine==24.2.*" carmaker-mcp

[mcp_servers.carmaker]
command = "uvx"
args = ["--python", "3.12", "--with", "matlabengine==24.2.*", "carmaker-mcp"]
env_vars = ["WINDIR"]

[mcp_servers.carmaker.env]
CM_PROJECT = "C:\\CM_Projects\\my-project"
CM_MODEL = "MyModel"

{
  "mcpServers": {
    "carmaker": {
      "command": "uvx",
      "args": ["--python", "3.12", "--with", "matlabengine==24.2.*", "carmaker-mcp"],
      "env": {
        "CM_PROJECT": "C:\\CM_Projects\\my-project",
        "CM_MODEL": "MyModel"
      }
    }
  }
}

JSON と TOML では、Windows のパスはバックスラッシュを 2 つ重ねるか、スラッシュで記述してください。これまでこのサーバーで使用されたのは Claude Code のみです。他のエントリーは、各クライアントのドキュメントに記載されている形式に従っています。

3. セッションを開始する

たとえば、「CarMaker を起動して、制動テストを実行して」とエージェントに依頼します。まだ開いていない場合は MATLAB、モデル、CarMaker GUI を開きますが、何も終了しません。

自分で MATLAB と CarMaker を開く場合は、サーバーが接続できるように、MATLAB セッションごとに 1 回実行するか（または startup.m に記述します）。

matlab.engine.shareEngine('cm_mcp')

スタンドアロンの実行では、どちらも必要ありません。

MATLAB MCP サーバーと併用する

CarMaker for Simulink で作業する場合は、MathWorks の MATLAB MCP Core Server も接続すると便利です。これは任意であり、 単独で実行する場合は必要ありません。2 つのサーバーはそれぞれ異なる役割を担います。

両方を使う際に知っておくべきこと：

• 同じ MATLAB セッションで両方を動作させます（開いている MATLAB を使うよう MATLAB サーバーを設定してください。詳細はその README を参照してください）。 こうすることで、両方から同じモデルとワークスペースを参照できます。開発中はこの方法で両方を使用しました。
• MATLAB は一度に 1 つの処理しか実行できません。モデルのコンパイル中やシミュレーションの実行中は、MATLAB サーバー経由の呼び出しは待機します。このサーバーの実行ツールはその動作を考慮し、時間制限付きの待機を繰り返すように設計されています。
• 実行の開始と停止には、このサーバーのツールを使います。これにより、実行（結果ファイル、エラー、保存モード）を追跡できます。
• MATLAB サーバー経由でスクリプトを実行すると、MATLAB の作業フォルダーが CarMaker プロジェクトの外に移動することがあります。その場合、CarMaker for Simulink は次回の起動時にプロジェクトディレクトリについて確認を求め、起動を停止します。このサーバーは、テスト実行を読み込む前または開始する前にフォルダーを元に戻し、そのことを結果に表示します。
• MATLAB サーバー経由で行った変更は、このサーバーの変更ログには記録されず、cm_revert_all でも取り消されません。
• 複数の MATLAB リリースがインストールされている場合は、MATLAB サーバーが CarMaker と同じリリースで動作するようにしてください（リリース名は carmaker-mcp doctor で確認できます）。MATLAB サーバーがより新しいリリースを起動すると、モデルも CarMaker セッションも認識できません。

1 つの CarMaker で複数の会話を行う場合。 クライアントと会話ごとにそれぞれサーバーが起動しますが、すべて同じ MATLAB と CarMaker を操作します。そのうち 1 つがパラメータースタディを実行している間、ほかのサーバーは読み込み、開始、停止を拒否し、誰が何を実行しているかを表示します。cm_status では study_running と表示されます。スタディ以外ではこのような制御は行われないため、2 つの会話がそれぞれ単一実行を開始すると、互いに干渉します。

設定

設定はすべてクライアントのエントリーにある環境変数で、上記の CM_PROJECT や CM_MODEL のように設定します。

共通

詳細設定

ツール

各ツールは、読み取り専用か、状態を変更するか、破壊的な操作を行うかをクライアントに伝えるため、必要に応じてクライアントは確認を求められます。各パラメーターの説明は docs/tools.mdにあります。

セッションと実行

結果

プロジェクトデータとパラメーター

スタンドアロン実行（MATLABなし）

履歴

サーバーは、リソース（carmaker://guide、carmaker://status、carmaker://changelog、 carmaker://log）と3つのプロンプト（run_and_summarise、compare_settings、undo_session）も提供します。

安全性とプライバシー

このサーバーはシミュレーションを開始し、プロジェクトファイルと実行中の Simulink モデルをその場で編集できます。信頼できるエージェントのみを接続してください。

作業を保護する仕組み：

• 各ファイルは最初に変更する前にバックアップされ、変更のたびに変更前の値がログに記録されます。また、cm_revert_all を実行するとセッションの変更を元に戻せます。
• ファイルへの書き込みはプロジェクトフォルダー内に限られ、シミュレーションが停止しているときだけ行われます。プロジェクトファイルを削除するツールはありません。
• 生の Tcl と Simulink 構造の編集は、CM_ENABLE で有効にしない限り無効です。
• デフォルトでは、CarMaker のポップアップはクリックされるまで待機します。CM_POPUP_TIMEOUT を設定すると、「Vehicle not saved. All changes will be lost. OK to continue?」のような質問にはデフォルトの回答が適用され、CarMaker GUI の未保存の変更は破棄されます。

実行時に生成される結果ファイルとログファイルは、プロジェクトの SimOutput フォルダーに書き込まれます。変更を元に戻しても、これらは削除されません。

このサーバーはテレメトリを収集せず、独自にネットワーク接続を確立することもありません。お使いのマシン上の MATLAB と CarMaker とのみ通信します。詳細： docs/safety.md。

トラブルシューティング

まず uvx carmaker-mcp doctor を実行してください。ほとんどのセットアップの問題と、その解決方法が表示されます。

詳細：docs/troubleshooting.md。 サーバー独自のログは、状態フォルダー内の server.log です。

仕組み

• MATLAB 接続セッション： サーバーは MATLAB Engine for Python を通じて MATLAB に接続し、CarMaker for Simulink 独自の cmguicmd（GUI の Tcl／ScriptControl インターフェース）を介して CarMaker GUI にコマンドを送信します。
• 単独実行： CarMaker の別プロセスを起動して制御するために、CarMaker のインストール先から読み込んだ IPG の Python API cmapi を使用します。
• プロジェクトファイルは CarMaker の infofile 形式に対応したバイト列を保持するエディターで編集され、結果は .erg ファイル用の NumPy リーダーで読み取られます（MATLAB の cmread と照合済み）。

IPG または MathWorks の製品は同梱も再配布もされません。

ドキュメントと貢献

• 詳細なセットアップ手順（pip、更新、単一ファイル実行可能ファイル）
• セッションの例
• ツールリファレンス
• 検証済みの項目
• 貢献：ほかの CarMaker および MATLAB バージョンでのテストレポートを特に歓迎します
• セキュリティポリシー

関連プロジェクト：pycarmaker は、単独実行の CarMaker プログラムのコマンドポートと通信します。このプロジェクトは CarMaker for Simulink にも対応し、IPG 独自のインターフェースを使用しており、pycarmaker とのコードの共有はありません。

ライセンス

MIT。詳細は LICENSE を参照してください。