MaxForge MCP

让 AI 代理（Claude，或任何支持 MCP 的其他工具）驱动一个实时的 3ds Max 会话——不是生成脚本让人手动粘贴，而是在 Max 打开时实时创建、编辑和动画化对象。

通常，让 AI 在 3ds Max 中帮忙意味着它写一个脚本，然后你自己运行，却无法得知它是否真的有效。这闭环了：代理可以在每次操作前后查询真实场景状态，捕捉自己的错误，并实时迭代，而不是猜测。

它能做什么

每个修改都包裹在真实的撤销块中——代理所做的任何操作都可以通过正常的 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)

一个小的 Python 桥接器在 3ds Max 内部运行，通过启动脚本加载，并打开一个仅绑定到 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 中添加匹配的包装器——其文档字符串是代理看到的内容。

3. 在 server/max_mcp_server.py 顶部的循环中注册它。

4. 在 Max 中运行“Reload MaxForge Bridge”宏脚本，而不是重启。

许可证

版权所有 (c) 2026 .bluntman420. — 参见 LICENSE.md。可自由 按原样使用；不允许修改和重新分发修改版本。