MaxForge MCP

Permite que un agente de IA (Claude, o cualquier otra cosa que hable MCP) controle una sesión de 3ds Max en vivo — no generando scripts para que un humano los pegue, sino creando, editando y animando objetos en tiempo real mientras Max está abierto.

Normalmente, conseguir que una IA ayude en 3ds Max significa que escribe un script y tú lo ejecutas tú mismo, sin saber si realmente funcionó. Esto cierra ese bucle: el agente puede consultar el estado real de la escena antes y después de cada acción, detectar sus propios errores e iterar en vivo en lugar de adivinar.

Qué puede hacer

Cada mutación está envuelta en un bloque de deshacer real: cualquier cosa que haga el agente está a un Ctrl+Z normal de deshacerse.

Related MCP server: Maya MCP Server

Cómo funciona

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

Un pequeño puente de Python se ejecuta dentro de 3ds Max, cargado mediante un script de inicio, y abre un socket vinculado solo a 127.0.0.1. Un servidor MCP fuera de Max se conecta a él y expone las herramientas anteriores. Cada comando se ejecuta en el hilo principal de Max mediante un temporizador Qt: el SDK de 3ds Max no es seguro para subprocesos, por lo que los comandos que llegan a un hilo de socket se ponen en cola y se drenan en el bucle principal en lugar de ejecutarse directamente.

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)

Configuración

Requisitos: 3ds Max 2022+ (pymxs), Python 3.10+ en la máquina que ejecuta el servidor MCP, uv.

1. Instalar dependencias

uv sync

2. Cargar el puente en 3ds Max

Copia max_side/startup_stub.ms en la carpeta de scripts de inicio de Max, normalmente:

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

Abre el startup_stub.ms copiado y establece MAXFORGE_REPO_PATH en el lugar donde hayas clonado este repositorio. Inicia el puente en el puerto 47823 automáticamente la próxima vez que se lance Max. También se registran tres macroscripts (categoría "MaxForge MCP") para control manual — Iniciar / Detener / Recargar — para que puedas recoger los cambios de código sin reiniciar Max.

3. Apuntar un cliente MCP a él

Para Claude Code:

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

O conecta server/max_mcp_server.py en la configuración de cualquier otro cliente compatible con MCP de la misma manera.

Seguridad

El socket solo se vincula a 127.0.0.1, nunca a la red. Este es un punto de ejecución de código dentro de una aplicación de modelado; está diseñado para que solo sea accesible desde la misma máquina en la que se ejecuta.

Estado

Probado en vivo contra una sesión de Max 2025 en ejecución con una suite completa basada en aserciones (29/29 comprobaciones) que cubre cada herramienta, cada ruta de error y un viaje de ida y vuelta de deshacer/rehacer.

create_collision_proxy actualmente solo construye una caja genérica alineada a los ejes; aún no está ajustado a ningún formato de colisión específico de motor de juego.

Añadir una nueva herramienta

1. Añade un manejador en max_side/commands.py, envuelto en undoable("MCP: ..."), registrado en el diccionario COMMANDS.

2. Añade un envoltorio correspondiente en server/tools.py — su docstring es lo que ve el agente.

3. Regístralo en el bucle al principio de server/max_mcp_server.py.

4. Ejecuta el macroscript "Reload MaxForge Bridge" en Max en lugar de reiniciar.

Licencia

Copyright (c) 2026 .bluntman420. — ver LICENSE.md. Libre de usar tal cual; no se permite la modificación ni la redistribución de versiones modificadas.