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에서 브리지가 자동으로 시작됩니다. 수동 제어를 위한 세 개의 매크로스크립트(카테고리 "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 참조. 있는 그대로 사용할 수 있습니다. 수정 및 수정 버전의 재배포는 허용되지 않습니다.