cinema4d-mcp

Overview

Cinema4D MCP Server is a Python-based implementation that integrates Claude AI with Cinema 4D, enabling AI-powered 3D content creation. The project consists of two main components: a Cinema 4D plugin that acts as a socket server and an MCP server that implements the Model Context Protocol. Together, they provide comprehensive tools for creating, modifying, and manipulating 3D scenes through natural language prompts. The server supports a wide range of Cinema 4D features including object creation, camera animation, materials, lighting, MoGraph tools, and Redshift shader integration.

Try asking AI

After installing, here are 4 things you can ask your AI assistant:

• get_scene_info

  Get summary info about the active Cinema 4D scene.

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

  List all scene objects with hierarchy.

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

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

  Try:Add a red cube to the sceneTry:Create a blue sphere
• create_camera

  Add a new camera to the scene.

  Try:Add a camera named mainCamTry:Create a camera with 35mm lens
• create_material

  Create a standard Cinema 4D material.

  Try:Create a red plastic materialTry:Make a reflective metal material
• apply_material

  Apply a material to a target object.

  Try:Apply the red material to the cubeTry:Add metal material to the sphere
• create_light

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

  Try:Add an omni lightTry:Create a spotlight
• animate_camera

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

  Try:Animate the camera to move left to rightTry:Create a camera animation following a spline
• create_mograph_cloner

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

  Try:Add a radial clonerTry:Create a grid cloner for objects
• render_preview

  Render a quick preview and return base64 image.

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

  Save the current Cinema 4D project to disk.

  Try:Save the current sceneTry:Save my project as final_scene.c4d
• execute_python

  Execute custom Python code inside Cinema 4D.

  Try:Run Python code to print selected objectsTry:Execute Python to get object positions

Comparable tools

Installation

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

What versions of Cinema 4D are supported?

Currently supports C4D 2024.0+ (Python 3.11). Limited compatibility testing for 2023.2+ versions. Older versions are not officially supported.

How do I troubleshoot connection issues?

Check log files with `tail -f ~/Library/Logs/Claude/mcp*.log`, verify Cinema 4D shows connections in its console, and test the wrapper script directly with `cinema4d-mcp-wrapper`.

Compare cinema4d-mcp with