3ds Max MCP Server

社区

通过模型上下文协议把 AI 代理接入 Autodesk 3ds Max

分类: 其他第 131 / 230
Stars: ★ 358 非常热门
传输方式: stdio（本地进程）
运行环境: Python 3.12+ · 预编译二进制 3dsmax-mcp-1.7.2-Set
凭据: 无需凭据
许可证: MIT
最近提交: 1 天前
工具数: 100

52FMRS · D

这是一个由个人开发者维护的非官方 MCP 服务器，用 MIT 许可发布，当前版本 1.7.2。它通过原生桥接把 AI 客户端连接到 Autodesk 3ds Max 2023–2027，提供约 160 个工具，范围从场景读写、建模与材质到插件内省、MCG、tyFlow、RailClone 与 Forest Pack（后者标注为进行中的工作）。能力覆盖面很广，但包含可执行 MAXScript/Python 的入口，需要明确的安全边界与权限评估。

最强项 · 文档质量 14/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

8/20

维护活跃度

11/20

文档质量

14/20

安装易用性

11/20

查看各项评分依据

可靠性 8/20: README 声称支持 160 个 MCP 工具、原生桥接 2023–2027 版本及大量插件工作流（tyFlow、MCG、RailClone、FStorm 等），但仓库根目录未提供可缓存的服务器清单（SERVER MANIFEST 未缓存），也没有看到任何 CI 工作流或已提交测试。静态审查无法验证 MCP 初始化握手、工具列表与实际行为是否一致，也无从确认错误处理与依赖可控性。工具数量极大而验证证据为零，不确定性只会扣分，不会加分；按照静态校准，未执行任何代码的情况下上限本为 12，此处因缺少测试与 CI 证据再向下取整至 8。
安全与权限 8/20: 本服务器会向 3ds Max 场景写入大量高副作用操作，包括执行任意 MAXScript（execute_maxscript）、执行 Python（execute_python，且注明需关闭 safe mode）、MCG 编译与补丁应用、写入 OSL 着色器到磁盘、批量导入/合并外部 .max 文件、以及读取桌面像素（capture_screen）。仓库提供了 safe mode、显式授权（如 add_dc_script_operator 要求 explicit authorization）和原子 undo 等设计线索，方向正确；但文档未说明权限边界、网络外发行为（Cosmos 下载、插件清单刷新）以及危险操作的强制确认机制，README 也未提供安全策略或披露渠道。缺少确认流程与数据流披露使该项无法超过 10。未发现恶意代码、凭据窃取或真实 token 示例，不触发红线。
维护活跃度 11/20: 证据显示这是一个持续维护的项目：README 标注当前版本 1.7.2、包含 CHANGELOG.md、MIT 许可、246 星、仅 3 个未关闭 issue 且未归档，RailClone 集成明确标记为 1.7.2 新增，Forest Pack 明确标注为 WIP 并提示早期阶段可能不完整，属于诚实的版本披露。扣分点在于：缺少可见的发布节奏/提交历史数据、无安全响应通道说明、无依赖更新策略说明，且所有权与治理信息缺失（仅有单一仓库路径）。因此给到中位偏上但未达高分的 11。
文档质量 14/20: 文档是本仓库最强的部分：README 分层清晰，给出需求（Windows、3ds Max 2023–2027、MCP 客户端）、快速开始、从源码安装的具体命令（git clone/uv sync/install.py）、以及按类别组织的完整工具目录（桥接、场景、对象、修改器、建模、材质、灯光、控制器、参数连线、组织、视口渲染、外部 .max、Data Channel、MCG、tyFlow、RailClone、Forest Pack、脚本诊断），并提供 docs/ADVANCED.md、docs/CHANGELOG.md、docs/FSTORM.md 等延伸阅读，还给出工具参数示例式用法（如 query_scene 的多种模式、execute_python 需关闭 safe mode）。扣分点在于：服务器清单未缓存、未说明认证/权限模型、缺少明确的成本与资源开销说明、也无故障排查章节（仅有 get_bridge_status 提示），且部分工具的完整参数表需跳转外部文档。综合取 14。
安装易用性 11/20: 安装路径较清晰：提供 Windows 安装器 3dsmax-mcp-1.7.2-Setup.exe 并可在安装时勾选客户端，也提供从源码安装的完整命令序列，要求 Python 3.12+、uv、Git，并明确要求关闭 Max 与 AI 客户端后再安装、更新时重复同样流程。但限制明显：仅支持 Windows 与 3ds Max 2023–2027，无跨平台方案；未在 README 内直接给出各主流客户端的配置示例（跳转 docs/ADVANCED.md 才可见手动配置与工具 profile）；原生桥接与依赖打包细节不透明；服务器清单未缓存也无法核对启动方式。属于「可用但需手动核对、平台受限」的情形，按静态校准上限 15，此处给 11。

静态评测 · 未实际运行收录于 2026-09-18

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码

适合谁

在 Windows 上使用 3ds Max 2023–2027 并希望通过 MCP 客户端以自然语言自动化 Max 的技术美术与 3D 从业者
需要把 Max 场景操作接入 AI 代理工作流（Claude Desktop、Codex、Cursor）的团队
希望通过内省与 MCG/MAXScript 扩展自定义工具的高级用户

不适合谁

使用 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

安装接入

准备工作

运行环境：Python 3.12+ · 预编译二进制 3dsmax-mcp-1.7.2-Set

关闭 3ds Max 并完全退出 AI 客户端。
运行 3dsmax-mcp-1.7.2-Setup.exe 并选择你的客户端。
打开 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。

验证是否装好

运行安装程序并重启 3ds Max 和你的 AI 客户端（Claude Desktop、Codex 或 Cursor）后，确认 get_bridge_status 和 get_session_context 等工具出现在客户端工具列表中，然后让它 ping 桥接——get_bridge_status 调用成功即证明原生连接正常。

常见排障

用 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 前确认安全模式设置符合需要

试试这样问

连接成功后，可以直接对 AI 助手这样说：

检查桥接状态，并给我当前 3ds Max 场景的概览。
用我项目文件夹里的贴图文件构建一个 PBR 材质，并把它赋给选中的对象。
把当前图层里的所有对象按批量命名规则重命名，并把它们编组。
检查这个对象的材质网络，列出缺失或异常的贴图。

工具能力 100

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 只读

获取对象的递归子级树

展开其余 92 个工具

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 写入

暂存、取回、重置、保存、场景信息

使用场景

从显式顶点和面构建可编辑多边形笼体，并检查拓扑质量

把贴图文件夹填充到材质编辑器调色板，并构建完整连线的 PBR 材质

批量导入资产文件夹到网格布局并自动指定 PBR 贴图

搜索 .max 文件并只合并所需对象

创建语义灯光与环境图，并在受保护条件下编辑灯光

通过内省探索已安装的 Max 类与插件 SDK 表面

用 MAXScript 或 Max Creation Graph 构建自定义工具

为交互会话截取视口、渲染图像并监视场景事件

支持客户端

Claude Desktop

Codex

Cursor

依据项目文档列出，未经本站实测。

详细介绍

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。