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 and full documentation: https://github.com/cl0nazepamm/3dsmax-mcp

Install

pip install 3dsmax-mcp
3dsmax-mcp-install

3dsmax-mcp-install deploys the native bridge plugin into Autodesk's ApplicationPlugins directory, writes user config, and registers the server with the AI clients it can find. Restart 3ds Max afterwards so the plugin loads.

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

Manual MCP client setup, tool profiles, safe mode and architecture notes are documented in docs/ADVANCED.md.

中文说明

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

用中文描述你要做的事，智能体调用 151 个专用 MCP 工具（核心配置 87 个）直接操作场景——创建物体、 构建材质、驱动修改器与控制器、截取视口、检查插件。不是让 AI 盲写 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

安装

国内建议使用清华 TUNA 镜像，速度更快：

pip install 3dsmax-mcp -i https://pypi.tuna.tsinghua.edu.cn/simple
3dsmax-mcp-install

3dsmax-mcp-install 会把原生桥接插件部署到 Autodesk 的 ApplicationPlugins 目录、写入用户配置， 并尽可能自动注册到已安装的 AI 客户端。装完请重启 3ds Max，插件才会加载。

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

国内常用的 Cline + DeepSeek 配置方式、建筑可视化与 MMD 动画上手示例、以及其他国内镜像， 见中文文档 README.zh-CN.md。

提 issue 用中文完全可以。