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 Server connects Cinema 4D to Claude, enabling prompt-assisted 3D manipulation.
To install the project, follow these steps:
To set up the Cinema 4D plugin, follow these steps:
c4d_plugin/mcp_server_plugin.pyp file to Cinema 4D's plugin folder. The path varies depending on your operating system:/Users/USERNAME/Library/Preferences/Maxon/Maxon Cinema 4D/plugins/C:\Users\USERNAME\AppData\Roaming\Maxon\Maxon Cinema 4D\plugins\To configure Claude Desktop, you need to modify its configuration file:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonTo test the Cinema 4D socket server directly from the command line:
You should see output confirming the server's successful start and connection to Cinema 4D.
The repository includes a simple test harness for running predefined command sequences:
tests/mcp_test_harness.jsonl): Contains a sequence of commands in JSONL format that can be executed in order. Each line represents a single MCP command with its parameters.tests/mcp_test_harness_gui.py): A simple Tkinter GUI for running the test commands:This test harness is particularly useful for:
get_scene_info: Get summary info about the active Cinema 4D scene. ✅list_objects: List all scene objects (with hierarchy). ✅group_objects: Group selected objects under a new null. ✅execute_python: Execute custom Python code inside Cinema 4D. ✅save_scene: Save the current Cinema 4D project to disk. ✅load_scene: Load a .c4d file into the scene. ✅set_keyframe: Set a keyframe on an objects property (position, rotation, etc.). ✅add_primitive: Add a primitive (cube, sphere, cone, etc.) to the scene. ✅modify_object: Modify transform or attributes of an existing object. ✅create_abstract_shape: Create an organic, non-standard abstract form. ✅create_camera: Add a new camera to the scene. ✅animate_camera: Animate a camera along a path (linear or spline-based). ✅create_light: Add a light (omni, spot, etc.) to the scene. ✅create_material: Create a standard Cinema 4D material. ✅apply_material: Apply a material to a target object. ✅apply_shader: Generate and apply a stylized or procedural shader. ✅validate_redshift_materials: Check Redshift material setup and connections. ✅ ⚠️ (Redshift materials not fully implemented)create_mograph_cloner: Add a MoGraph Cloner (linear, radial, grid, etc.). ✅add_effector: Add a MoGraph Effector (Random, Plain, etc.). ✅apply_mograph_fields: Add and link a MoGraph Field to objects. ✅create_soft_body: Add a Soft Body tag to an object. ✅apply_dynamics: Apply Rigid or Soft Body physics. ✅render_frame: Render a frame and save it to disk (file-based output only). ⚠️ (Works, but fails on large resolutions due to MemoryError: Bitmap Init failed. This is a resource limitation.)render_preview: Render a quick preview and return base64 image (for AI). ✅snapshot_scene: Capture a snapshot of the scene (objects + preview image). ✅| Cinema 4D Version | Python Version | Compatibility Status | Notes |
|---|---|---|---|
| R21 / S22 | Python 2.7 | ❌ Not supported | Legacy API and Python version too old |
| R23 | Python 3.7 | 🔍 Not planned | Not currently tested |
| S24 / R25 / S26 | Python 3.9 | ⚠️ Possible (TBD) | Requires testing and fallbacks for missing APIs |
| 2023.0 / 2023.1 | Python 3.9 | 🧪 In progress | Targeting fallback support for core functionality |
| 2023.2 | Python 3.10 | 🧪 In progress | Aligns with planned testing base |
| 2024.0 | Python 3.11 | ✅ Supported | Verified |
| 2025.0+ | Python 3.11 | ✅ Fully Supported | Primary development target |
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Connects Cinema 4D to Claude, enabling AI-assisted 3D modeling and scene manipulation through natural language commands.