适合谁
- 在 Windows 上使用 3ds Max 2023–2027 并希望通过 MCP 客户端以自然语言自动化 Max 的技术美术与 3D 从业者
- 需要把 Max 场景操作接入 AI 代理工作流（Claude Desktop、Codex、Cursor）的团队
- 希望通过内省与 MCG/MAXScript 扩展自定义工具的高级用户
3
52FMRS · D
这是一个由个人开发者维护的非官方 MCP 服务器，用 MIT 许可发布，当前版本 1.7.2。它通过原生桥接把 AI 客户端连接到 Autodesk 3ds Max 2023–2027，提供约 160 个工具，范围从场景读写、建模与材质到插件内省、MCG、tyFlow、RailClone 与 Forest Pack（后者标注为进行中的工作）。能力覆盖面很广，但包含可执行 MAXScript/Python 的入口，需要明确的安全边界与权限评估。
3dsmax-mcp 是一个 MCP 服务器，通过原生桥接把 AI 代理连接到 Autodesk 3ds Max，提供约 160 个 MCP 工具，覆盖场景读取、建模、材质、修改器、控制器、视口截图、程序化图形与插件工作流。它同时支持对任意 Max 类的内省，并内置 MAXScript 文档形式的代理技能。使用前提为 Windows 系统、Autodesk 3ds Max 2023–2027，以及一个 MCP 客户端（例如 Claude Desktop、Codex 或 Cursor）。官方提供安装程序，也可从源码安装（Python 3.12+、uv、Git）。项目采用 MIT 许可，当前版本 1.7.2。
工具能力
get_bridge_status
诊断连接错误时探测 MCP 桥接状态
get_session_context
在一次调用中汇总桥接状态、能力、场景摘要与选择集
get_plugin_capabilities
获取 Max 版本、渲染器、已安装插件与类计数
query_scene
统一读取：overview、filter、class、property、selection、delta
resolve_node_refs
把名称、句柄或层级路径解析为经过交叉校验的规范 NodeRef
scene_qa
扫描场景图规范问题并执行明确的安全命名修复；不分析网格
scene_patch
预检并在一个原生撤销步骤中原子应用最多 256 项机械式节点编辑
get_hierarchy
获取对象的递归子级树
get_instances
获取共享同一基础对象的所有实例
get_dependencies
通过 dependents/dependent 节点查看引用图
create_object
创建几何体并给出空间放置反馈
delete_objects
按名称删除对象
get_object_properties
获取单个对象的紧凑属性
set_object_property
设置单个对象属性
transform_object
按偏移移动、旋转和/或缩放
analyze_node_orientation
获取轴心、包围盒、局部坐标轴与世界矩阵，用于绑定与放置
clone_objects
复制、实例或参考克隆
set_parent
设置或解除父子关系
select_objects
更改当前选择集
set_visibility
显示、隐藏、冻结或解冻
batch_rename_objects
一次调用重命名多个对象
add_modifier
为对象添加修改器
remove_modifier
按名称移除修改器
set_modifier_state
按视口/渲染粒度启用或禁用修改器
set_modifier_property
为一个或多个对象设置修改器参数
collapse_modifier_stack
塌陷修改器堆栈
make_modifier_unique
解除共享修改器的实例关系
inspect_modifier_properties
inspect_properties(target="modifier") 的兼容别名
curve_model
创建命名曲线、圆角轮廓、扫掠与四边放样，控制参数保存在场景中
inspect_curve
检查、可视化选中并编辑样条节点与手柄，带过期令牌保护
edit_curve
检查、可视化选中并编辑样条节点与手柄，带过期令牌保护
create_mesh
用显式顶点和面构建可编辑多边形笼体
inspect_mesh
读取笼体几何、标注组件并把图像位置映射到编辑目标
pick_component
读取笼体几何、标注组件并把图像位置映射到编辑目标
mesh_edit
可撤销的顶点、边和面编辑，同时保留修改器堆栈
loft_mesh
带持久数值参数的等截面四边放样
geometry_qa
检查网格边界、绕序、退化面与连通分量
boolean_operation
应用、检查、重调、重命名或提取布尔修改器操作对象；支持内联重复切割体
draw_spline
用显式世界空间点和节点创建、读取和编辑样条形状
edit_vertices
在世界空间中读取、移动、设置或对齐可编辑多边形顶点
get_materials
列出场景中已指定的材质
get_material_library
检查 currentMaterialLibrary 与材质编辑器暂存槽
backup_material_library
把临时/暂存材质库保存为 .mat 文件
get_material_slots
读取材质的紧凑槽位/属性信息
inspect_material_network
语义化材质图、已连接槽位、贴图清单与健康检查
replicate_material
预览/应用保持结构的材质克隆与贴图重映射
assign_material
创建材质并指定给对象
set_material_property
设置对象材质上的单个属性
set_material_properties
一次设置多个材质属性
set_sub_material
创建或指定 Multi/Sub-Object 槽位
create_texture_map
创建贴图（保存为 MAXScript 全局变量）
set_texture_map_properties
编辑贴图全局变量
create_material_from_textures
从贴图文件构建完整连线的 PBR 材质
create_shell_material
把任意渲染与导出材质包装进 Shell Material（双管线）
write_osl_shader
将 OSL 写入磁盘并编译 OSLMap
replace_material
在所有使用处把一个材质替换为另一个
batch_replace_materials
批量替换材质
palette_laydown
从贴图文件夹填充材质编辑器调色板槽位
smart_import
从文件夹批量导入网格并自动指定 PBR 材质
cosmos_search
查找兼容的 Cosmos 模型、材质与 HDRI
cosmos_download
下载 Cosmos 资产而不导入
cosmos_import
通过 Corona 或 V-Ray 导入 Cosmos 资产
inspect_object
对象的深度探索性摘要
inspect_properties
深度属性导出（target="object"|"modifier"|"baseobject"|"material"）
introspect_osl
OSLMap 与着色器类的 API 表面
walk_references
完整的引用依赖遍历
learn_scene_patterns
分析当前场景中的类使用模式
map_class_relationships
类之间的 ParamBlock2 引用关系
watch_scene
面向交互会话的实时事件监视器
isolate_and_capture_selected
按选择隔离截取视口图像
main_thread
检查或清理运行在 Max 主/UI 线程上的回调与定时器
discover_plugin_surface
查找插件相关类与入口点
discover_plugin_classes
枚举已注册的 SDK 类
list_plugin_classes
列出某个插件或超类家族的类
inspect_plugin_class
SDK schema v2：有界元数据、精确绑定与枚举来源；保留旧版反射
inspect_plugin_constructor
插件类的创建说明
inspect_plugin_instance
SDK schema v2：实时值、关联映射与受保护的编辑令牌
plugin_patch
原子化类型化 PB2 编辑，带读回与过期/共享/动画保护
get_plugin_manifest
结构化清单（类、工作流、注意事项）
refresh_plugin_manifest
从实时运行时重建清单
introspect_class
SDK 参数描述符与已发布接口元数据
introspect_instance
带实时值的深度 SDK 内省
lighting_capabilities
已安装渲染器路径、发光体形状、单位与颜色策略
create_lights
在一个经过验证的原生事务中创建语义灯光与环境图
inspect_lights
解析实际灯光设置与关联的发光贴图
edit_lights
受保护的颜色、输出、尺寸、启用与阴影编辑
assign_controller
创建并指定控制器到子动画轨迹
inspect_controller
检查单个控制器轨迹
inspect_track_view
轨迹视图风格的控制器层级
set_controller_props
编辑脚本文本或控制器属性
add_controller_target
为脚本/表达式/约束控制器添加目标
keyframe_tracks
时间线控制；有界删除/移动/缩放、烘焙/重采样、切线归一化、姿态匹配与循环
list_wireable_params
发现对象上可连线的子动画项
wire_params
用连线表达式连接参数
get_wired_params
列出已有的连线连接
unwire_params
移除连线
manage_layers
创建、删除、列出和配置图层；移动/选择对象
manage_groups
创建、解组、打开、关闭、附加、分离组
manage_selection_sets
命名选择集
manage_scene
暂存、取回、重置、保存、场景信息
安装接入
- 关闭 3ds Max 并完全退出 AI 客户端。2. 运行 3dsmax-mcp-1.7.2-Setup.exe 并选择你的客户端。3. 打开 3ds Max 并重启 AI 客户端。安装程序包含 Python、依赖、原生桥接与代理技能。更新时，先关闭 Max 与客户端，再运行新的安装程序。从源码安装（需 Python 3.12+、uv 与 Git，安装前关闭 Max 与 AI 客户端）：git clone https://github.com/cl0nazepamm/3dsmax-mcp.git；cd 3dsmax-mcp；uv sync；uv run python install.py。使用默认的 Full 工具配置。更新时执行 git pull、uv sync，然后再次运行 uv run python install.py。
选型与风险
不适合谁
- 使用 Windows 以外操作系统或 3ds Max 2022 及更早版本的用户
- 不希望 AI 客户端直接修改或删除场景内容的用户
- 只需要静态查看 3ds Max 文件而无需自动化操作的用户
所需权限
- 控制 3ds Max 场景：创建、修改、删除对象与材质
- 读写场景文件与 .mat 材质库文件（保存、暂存、合并、扫描 .max 文件）
- 在 Max 中执行 MAXScript 与 Python 代码（execute_python 需要关闭安全模式）
- 截取视口、屏幕与渲染图像
- 通过已安装的导入/导出器读写外部资产与贴图文件
- 通过 Cosmos 工具联网搜索与下载资产
风险与副作用
- execute_maxscript 与 execute_python 可在 Max 内执行任意代码；execute_python 需关闭安全模式，风险显著提高
- 脚本与批处理操作可能修改或删除场景对象、材质与文件，误操作可能造成不可逆影响（部分操作有撤销与 preflight 保护）
- 写入 .mat、保存场景或导出资产会改动本机文件
- tyFlow、RailClone、Forest Pack 等集成处于不同成熟度（Forest Pack 明确标注为进行中的工作），可能不完整或随版本变化
- 依赖原生桥接，仅支持 3ds Max 2023–2027
常见排障
- 用 get_bridge_status 探测桥接状态，诊断连接错误
- 确认已关闭并重新启动 3ds Max 与 AI 客户端（更新安装后尤其重要）
- 确认 3ds Max 版本在 2023–2027 范围内，且 MCP 客户端已选中安装
- 用 get_plugin_capabilities 检查 Max 版本、渲染器与已安装插件
- 从源码安装时确认 Python 3.12+、uv 与 Git 已就绪，并再次运行 uv run python install.py
- 调用 execute_python 前确认安全模式设置符合需要
使用场景
从显式顶点和面构建可编辑多边形笼体，并检查拓扑质量
把贴图文件夹填充到材质编辑器调色板，并构建完整连线的 PBR 材质
批量导入资产文件夹到网格布局并自动指定 PBR 贴图
搜索 .max 文件并只合并所需对象
创建语义灯光与环境图，并在受保护条件下编辑灯光
通过内省探索已安装的 Max 类与插件 SDK 表面
用 MAXScript 或 Max Creation Graph 构建自定义工具
为交互会话截取视口、渲染图像并监视场景事件
支持客户端
Claude Desktop完整支持
Codex完整支持
Cursor完整支持