cinema4d-mcp

概述

Cinema4D MCP 服务器是一个基于 Python 的实现，将 Claude AI 与 Cinema 4D 集成，实现 AI 驱动的 3D 内容创作。项目包含两个主要组件：作为服务器的 Cinema 4D 插件和实现模型上下文协议的 MCP 服务器。它们共同提供通过自然语言提示创建、修改和操作 3D 场景的全面工具。该服务器支持广泛的 Cinema 4D 功能，包括对象创建、相机动画、材质、灯光、MoGraph 工具和 Redshift 着色器集成。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• get_scene_info

  Get summary info about the active Cinema 4D scene.

  试试:What's in the current scene?试试:Show me scene summary
• list_objects

  List all scene objects with hierarchy.

  试试:List all objects in the scene试试:What objects are in my scene hierarchy?
• add_primitive

  Add a primitive (cube, sphere, cone, etc.) to the scene.

  试试:Add a red cube to the scene试试:Create a blue sphere
• create_camera

  Add a new camera to the scene.

  试试:Add a camera named mainCam试试:Create a camera with 35mm lens
• create_material

  Create a standard Cinema 4D material.

  试试:Create a red plastic material试试:Make a reflective metal material
• apply_material

  Apply a material to a target object.

  试试:Apply the red material to the cube试试:Add metal material to the sphere
• create_light

  Add a light (omni, spot, etc.) to the scene.

  试试:Add an omni light试试:Create a spotlight
• animate_camera

  Animate a camera along a path (linear or spline-based).

  试试:Animate the camera to move left to right试试:Create a camera animation following a spline
• create_mograph_cloner

  Add a MoGraph Cloner (linear, radial, grid, etc.).

  试试:Add a radial cloner试试:Create a grid cloner for objects
• render_preview

  Render a quick preview and return base64 image.

  试试:Render a preview of the scene试试:Show me what the scene looks like
• save_scene

  Save the current Cinema 4D project to disk.

  试试:Save the current scene试试:Save my project as final_scene.c4d
• execute_python

  Execute custom Python code inside Cinema 4D.

  试试:Run Python code to print selected objects试试:Execute Python to get object positions

可对比工具

安装

git clone https://github.com/ttiimmaacc/cinema4d-mcp.git
cd cinema4d-mcp

pip install -e .

chmod +x bin/cinema4d-mcp-wrapper

"mcpServers": {
  "cinema4d": {
    "command": "python3",
    "args": ["/path/to/cinema4d-mcp/main.py"]
  }
}

FAQ

支持哪些版本的 Cinema 4D？

目前支持 C4D 2024.0+（Python 3.11）。对 2023.2+ 版本的兼容性测试有限。不官方支持旧版本。

如何解决连接问题？

使用 `tail -f ~/Library/Logs/Claude/mcp*.log` 检查日志文件，验证 Cinema 4D 控制台是否显示连接，并直接使用 `cinema4d-mcp-wrapper` 测试包装脚本。

cinema4d-mcp 对比