MaxForge MCP

Ermöglicht es einem KI-Agenten (Claude oder allem anderen, das MCP spricht), eine live 3ds-Max-Sitzung zu steuern – nicht indem Skripte generiert werden, die ein Mensch einfügen muss, sondern indem Objekte in Echtzeit erstellt, bearbeitet und animiert werden, während Max geöffnet ist.

Normalerweise bedeutet es, wenn man KI in 3ds Max um Hilfe bittet, dass sie ein Skript schreibt und man es selbst ausführt, ohne zu wissen, ob es tatsächlich funktioniert hat. Das schließt diese Schleife: Der Agent kann den echten Szenenzustand vor und nach jeder Aktion abfragen, seine eigenen Fehler erkennen und live iterieren, statt zu raten.

Was es kann

Jede Änderung ist in einen echten Undo-Block eingebettet – alles, was der Agent tut, ist mit einem normalen Strg+Z rückgängig zu machen.

Related MCP server: Maya MCP Server

So funktioniert es

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

Eine kleine Python-Brücke läuft in 3ds Max, wird über ein Startskript geladen und öffnet einen Socket, der nur an 127.0.0.1 gebunden ist. Ein MCP-Server außerhalb von Max verbindet sich damit und stellt die oben genannten Werkzeuge bereit. Jeder Befehl läuft über einen Qt-Timer im Hauptthread von Max – das 3ds-Max-SDK ist nicht threadsicher, daher werden Befehle, die auf einem Socket-Thread eintreffen, in eine Warteschlange gestellt und in der Hauptschleife abgearbeitet, statt direkt ausgeführt zu werden.

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)

Einrichtung

Anforderungen: 3ds Max 2022+ (pymxs), Python 3.10+ auf dem Rechner, auf dem der MCP-Server läuft, uv.

1. Abhängigkeiten installieren

uv sync

2. Die Bridge in 3ds Max laden

Kopieren Sie max_side/startup_stub.ms in den Startskript-Ordner von Max – normalerweise:

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

Öffnen Sie die kopierte startup_stub.ms und setzen Sie MAXFORGE_REPO_PATH auf den Ort, an dem Sie dieses Repository geklont haben. Es startet die Bridge beim nächsten Start von Max automatisch auf Port 47823. Drei Makroskripte (Kategorie „MaxForge MCP") sind ebenfalls für die manuelle Steuerung registriert – Start / Stopp / Neuladen –, sodass Sie Codeänderungen übernehmen können, ohne Max neu zu starten.

3. Einen MCP-Client darauf ausrichten

Für Claude Code:

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

Oder binden Sie server/max_mcp_server.py auf die gleiche Weise in die Konfiguration eines anderen MCP-kompatiblen Clients ein.

Sicherheit

Der Socket bindet ausschließlich an 127.0.0.1 – niemals an das Netzwerk. Dies ist ein Code-Ausführungs-Endpunkt in einer Modellierungsanwendung; er ist so konzipiert, dass er nur vom selben Rechner aus erreichbar ist, auf dem er läuft.

Status

Live getestet gegen eine laufende Max-2025-Sitzung mit einer vollständigen, auf Assertions basierenden Suite (29/29 Prüfungen), die jedes Werkzeug, jeden Fehlerpfad und einen Undo/Redo-Roundtrip abdeckt.

create_collision_proxy erstellt derzeit nur einen generischen achsenausgerichteten Quader – er ist noch nicht auf das Kollisionsformat einer bestimmten Spiel-Engine abgestimmt.

Neues Werkzeug hinzufügen

1. Fügen Sie einen Handler in max_side/commands.py hinzu, eingebettet in undoable("MCP: ..."), registriert im COMMANDS-Wörterbuch.

2. Fügen Sie einen passenden Wrapper in server/tools.py hinzu – sein Docstring ist das, was der Agent sieht.

3. Registrieren Sie ihn in der Schleife am Anfang von server/max_mcp_server.py.

4. Führen Sie das Makroskript „Reload MaxForge Bridge" in Max aus, statt neu zu starten.

Lizenz

Copyright (c) 2026 .bluntman420. – siehe LICENSE.md. Frei zur Nutzung wie besehen; Änderung und Weiterverbreitung geänderter Versionen ist nicht gestattet.