Enables 3D scene manipulation in Cinema 4D, including creating and modifying objects, managing materials, setting up lighting, working with cameras, utilizing MoGraph tools, applying physics, and rendering scenes.
Cinema4D MCP 服务器将 Cinema 4D 连接到 Claude，实现快速辅助的 3D 操作。
要安装该项目，请按照以下步骤操作：
要设置 Cinema 4D 插件，请按照以下步骤操作：
c4d_plugin/mcp_server_plugin.pyp文件复制到 Cinema 4D 的插件文件夹。具体路径取决于您的操作系统：/Users/USERNAME/Library/Preferences/Maxon/Maxon Cinema 4D/plugins/C:\Users\USERNAME\AppData\Roaming\Maxon\Maxon Cinema 4D\plugins\要配置Claude Desktop，需要修改其配置文件：
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json要直接从命令行测试 Cinema 4D 套接字服务器：
您应该会看到确认服务器成功启动并连接到 Cinema 4D 的输出。
该存储库包含一个用于运行预定义命令序列的简单测试工具：
tests/mcp_test_harness.jsonl )：包含 JSONL 格式的一系列可按顺序执行的命令。每行代表一个 MCP 命令及其参数。tests/mcp_test_harness_gui.py ）：用于运行测试命令的简单 Tkinter GUI：该测试工具特别适用于：
get_scene_info ：获取有关活动 Cinema 4D 场景的摘要信息。✅list_objects ：列出所有场景对象（带层次结构）。✅group_objects ：将选定的对象分组到新的 null 下。✅execute_python Python 代码save_scene ：将当前 Cinema 4D 项目保存到磁盘。✅load_scene ：将.c4d文件加载到场景中。✅set_keyframe ：为对象属性（位置、旋转等）设置关键帧。✅add_primitive ：向场景添加一个基本体（立方体、球体、圆锥体等）。✅modify_object ：修改现有对象的变换或属性。✅create_abstract_shape ：创建一个有机的、非标准的抽象形式。✅create_camera ：向场景添加新相机。✅animate_camera ：沿路径（线性或基于样条曲线）为相机设置动画。✅create_light ：向场景添加灯光（全光、聚光灯等）。✅create_material ：创建标准 Cinema 4D 材质。✅apply_material ：将材质应用于目标对象。✅apply_shader ：生成并应用风格化或程序化的着色器。✅validate_redshift_materials Redshift 材质设置和连接。✅⚠️（Redshift 材质尚未完全实现）create_mograph_cloner ：添加 MoGraph 克隆器（线性、径向、网格等）。✅add_effector ：添加 MoGraph 效果器（随机、普通等）。✅apply_mograph_fields ：添加并链接 MoGraph 字段到对象。✅create_soft_body ：向对象添加 Soft Body 标签。✅apply_dynamics ：应用刚体或软体物理。✅render_frame ：渲染一帧并将其保存到磁盘（仅限基于文件的输出）。⚠️（可以正常工作，但在高分辨率下会失败，原因是 MemoryError: Bitmap Init failed。这是资源限制。）render_preview ：渲染快速预览并返回 base64 图像（用于 AI）。✅snapshot_scene ：捕获场景快照（对象 + 预览图像）。✅| Cinema 4D版本 | Python 版本 | 兼容性状态 | 笔记 |
|---|---|---|---|
| R21/S22 | Python 2.7 | ❌ 不支持 | 遗留 API 和 Python 版本太旧 |
| R23 | Python 3.7 | 🔍 没有计划 | 目前尚未测试 |
| S24/R25/S26 | Python 3.9 | ⚠️ 可能（待定） | 需要对缺失的 API 进行测试和回退 |
| 2023.0 / 2023.1 | Python 3.9 | 🧪 进行中 | 针对核心功能的后备支持 |
| 2023.2 | Python 3.10 | 🧪 进行中 | 与计划中的测试基地保持一致 |
| 2024.0 | Python 3.11 | ✅ 支持 | 已验证 |
| 2025.0+ | Python 3.11 | ✅ 全面支持 | 主要发展目标 |
This server cannot be installed
将 Cinema 4D 连接到 Claude，通过自然语言命令实现 AI 辅助 3D 建模和场景操作。