MaxForge MCP

AIエージェント（Claudeや、MCPを話す他の何か）が、ライブの3ds Maxセッションを操作できるようにします。人間が貼り付けるためのスクリプトを生成するのではなく、Maxが開いている間に実際にオブジェクトを作成・編集・アニメーション化します。

通常、3ds MaxでAIの助けを得るということは、AIがスクリプトを書き、それを自分で実行し、実際に機能したかどうかは分からないということを意味します。これにより、そのループが閉じられます。エージェントは、各アクションの前後に実際のシーン状態を照会し、自分のミスを検出し、推測する代わりにライブで反復処理できます。

できること

すべての変更は実際のアンドゥブロックでラップされています。エージェントが行うことはすべて、通常のCtrl+Zで元に戻せます。

Related MCP server: Maya MCP Server

仕組み

AI agent (MCP client) --stdio--> server/max_mcp_server.py --TCP, localhost only--> max_side/bridge.py (inside 3ds Max)

3ds Max内で実行される小さなPythonブリッジが、スタートアップスクリプトを介して読み込まれ、127.0.0.1にのみバインドされたソケットを開きます。Maxの外部にあるMCPサーバーがそれに接続し、上記のツールを公開します。すべてのコマンドはQtタイマーを介してMaxのメインスレッドで実行されます。3ds Max SDKはスレッドセーフではないため、ソケットスレッドで到着したコマンドはキューに入れられ、直接実行されるのではなくメインループで処理されます。

max_side/
  bridge.py      socket + main-thread queue (the only place pymxs is touched)
  commands.py    one function per tool, each wrapped in an undo block
  serialize.py   converts pymxs values (Point3, Matrix3, nodes, ...) to JSON
  startup_stub.ms   drop into Max's startup scripts folder
server/
  client.py         TCP client, newline-delimited JSON
  tools.py           MCP tool definitions
  max_mcp_server.py  the MCP server itself (stdio transport)

セットアップ

要件: 3ds Max 2022+ (pymxs)、MCPサーバーを実行するマシン上のPython 3.10+、uv。

1. 依存関係をインストール

uv sync

2. ブリッジを3ds Maxに読み込む

max_side/startup_stub.msをMaxのスタートアップスクリプトフォルダにコピーします。通常は次の場所です:

%LOCALAPPDATA%\Autodesk\3dsMax\<version>\ENU\scripts\startup\

コピーしたstartup_stub.msを開き、MAXFORGE_REPO_PATHをこのリポジトリをクローンした場所に設定します。次回Maxが起動すると、ポート47823でブリッジが自動的に起動します。手動制御用の3つのマクロスクリプト（カテゴリ「MaxForge MCP」）も登録されます — 開始/停止/再読み込み — これにより、Maxを再起動せずにコードの変更を反映できます。

3. MCPクライアントをポイントする

Claude Codeの場合:

claude mcp add maxforge -- <repo>\.venv\Scripts\python.exe <repo>\server\max_mcp_server.py

または、server/max_mcp_server.pyを他のMCP互換クライアントの設定に同じ方法で配線します。

安全性

ソケットは常に127.0.0.1にのみバインドされます — ネットワークには決して公開されません。これはモデリングアプリ内にあるコード実行エンドポイントであり、同じマシンからのみ到達可能になるように設計されています。

ステータス

実行中のMax 2025セッションに対して、すべてのツール、すべてのエラーパス、およびアンドゥ/リドゥの往復をカバーする完全なアサーションベースのスイート（29/29チェック）でライブテスト済みです。

create_collision_proxyは現在、汎用の軸平行ボックスのみを生成します。特定のゲームエンジンの衝突形式にはまだ調整されていません。

新しいツールの追加

1. max_side/commands.pyにハンドラーを追加し、undoable("MCP: ...")でラップし、COMMANDSディクショナリに登録します。

2. server/tools.pyに対応するラッパーを追加します — そのdocstringがエージェントに表示されるものです。

3. server/max_mcp_server.pyの先頭のループに登録します。

4. Maxで「Reload MaxForge Bridge」マクロスクリプトを実行します（再起動の代わりに）。

ライセンス

Copyright (c) 2026 .bluntman420. — LICENSE.mdを参照してください。そのまま使用は自由です。変更および変更版の再配布は許可されていません。