SuperAPI AI 工具集

cinema4d-mcp

智能体与模型

查看项目

更新于 10-16 01:11

技能介绍

用途:该技能面向 Cinema 4D 场景数据提取与脚本控制,基于 vladmdgolam/cinema4d-mcp 分支。适用于需要从 C4D 场景导出对象、克隆器动画、关键帧或 Redshift 材质信息的场景。

主要能力:提供结构化 MCP 工具(get_scene_info、list_objects、add_primitive 等)处理简单操作;execute_python_script 作为复杂提取的主路径,可访问完整 c4d 与 maxon API。分支新增 inspect_redshift_materials 只读检查器,支持材质分配、预览色与重复名提示,并可在节点空间访问失败时回退到 redshift.GetRSMaterialNodeMaster。

使用方式:先做健康检查,调用 get_scene_info 并用 execute_python_script 打印 ok。MoGraph 烘焙需按帧顺序推进:doc.SetTime 后调用 doc.ExecutePasses,再读取 GeGetMoData 的 MODATA_MATRIX;克隆器局部坐标须乘以 GetMg() 转为世界坐标。大范围烘焙应分块执行以避免超时。遍历对象使用栈式迭代,避免递归。Redshift 材质优先用 maxon 节点空间 API 遍历节点与端口,也可用二进制解析脚本 extract_rs_binary.py 读取标量端口值。

限制:插件版本可能落后于仓库副本,修改后需重启 Cinema 4D。部分构建上 GetDefaultValue 可能返回 None,GetEffectivePortValue 可能不存在,此时需改用渲染采样或二进制解析。材质基础色不是直接存储值,需用 GetPreview(0) 或发射探针近似获取。连接布线格式仍在逆向中。可见性常量 MODE_OFF=1、MODE_ON=0 与直觉相反,应使用常量而非整数。具体收费、平台与效果资料暂未提供。