3dsmax-mcp

Connect AI agents to Autodesk 3ds Max through the Model Context Protocol.

Ask in natural language; the agent creates objects, builds materials, drives modifiers and controllers, captures viewports, and inspects plugins through 151 dedicated MCP tools (87 in the core profile) — not through blind MAXScript feedback loops.

• Native bridge — a C++ plugin for 3ds Max 2023–2027, no MAXScript polling
• Introspection — discover arbitrary Max classes, plugin surfaces, and parameters at runtime
• Deep plugin support — tyFlow, Data Channel, MCG, OSL, Forest Pack, RailClone, Octane
• Bundled agent skill — MAXScript reference shipped for writing your own tools

MIT licensed. Source: https://github.com/cl0nazepamm/3dsmax-mcp

⚠️ Installation

This package is a name placeholder — pip install 3dsmax-mcp does not give you a working server yet.

3dsmax-mcp ships with a native 3ds Max bridge plugin (.gup) that must be deployed into Autodesk's ApplicationPlugins directory. pip cannot do that, so installation runs from the repository:

git clone https://github.com/cl0nazepamm/3dsmax-mcp.git
cd 3dsmax-mcp
uv sync
uv run python install.py

Restart 3ds Max, then connect your MCP client. The installer registers the server where it can; manual client setup is documented in docs/ADVANCED.md.

Requirements: Windows · Python 3.10+ · uv · 3ds Max 2023–2027

中文说明

3dsmax-mcp 通过 Model Context Protocol 把 AI 智能体接入 Autodesk 3ds Max。

用自然语言下达指令，智能体即可创建物体、构建材质、驱动修改器与控制器、截取视口、检查插件—— 全部通过 151 个专用 MCP 工具（核心配置 87 个）完成，而不是靠反复试错的 MAXScript 脚本循环。

• 原生桥接：3ds Max 2023–2027 的 C++ 插件，无需 MAXScript 轮询
• 运行时自省：可发现任意 Max 类、插件接口与参数
• 深度插件支持：tyFlow、Data Channel、MCG、OSL、Forest Pack、RailClone、Octane
• 内置智能体技能包：附带 MAXScript 参考文档，方便你编写自己的工具

MIT 开源协议。源码地址：https://github.com/cl0nazepamm/3dsmax-mcp

⚠️ 安装方式

本 PyPI 包目前仅用于占位，pip install 3dsmax-mcp 还不能直接得到可用的服务器。

3dsmax-mcp 需要配套的 3ds Max 原生桥接插件（.gup），该插件必须部署到 Autodesk 的 ApplicationPlugins 目录，pip 无法完成这一步。请从源码安装：

git clone https://github.com/cl0nazepamm/3dsmax-mcp.git
cd 3dsmax-mcp
uv sync
uv run python install.py

然后重启 3ds Max，并连接你的 MCP 客户端。

环境要求： Windows · Python 3.10+ · uv · 3ds Max 2023–2027