cinema4d

Cinema4D MCP Server acts as a bridge between Cinema 4D and Claude, enabling prompt-driven interactions to manipulate 3D scenes. The server implements the MCP protocol and exposes a suite of tool commands that can be invoked from Claude Desktop to query scene information, create or modify objects, control cameras, and manage rendering or animation tasks within Cinema4D. The available commands cover core operations such as getting scene info, listing and grouping objects, creating primitives, applying materials and shaders, setting keyframes, rendering frames, and driving MoGraph elements. To use it, start the Cinema4D socket server alongside the MCP server, then configure Claude Desktop to point at the Cinema4D MCP server so you can access the hammer icon toolset for MCP commands.

Once configured, you can issue commands through Claude’s MCP tools to perform actions like retrieving the current scene summary, creating a cube or sphere, placing a camera, applying a material to a selected object, or executing custom Python code inside Cinema4D. The integration is designed to be scriptable and testable via the included test harness, making it possible to reproduce complex scenes and workflows by stringing together MCP commands in JSONL files or using the GUI tester. The command surface also includes debugging and inspection aids, such as an MCP Inspector, to help diagnose connectivity and protocol issues.

Prerequisites

• Cinema 4D (R2024+ recommended)
• Python 3.10 or higher

Step 1: Clone the repository

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

Step 2: Install the MCP Server package in editable mode

pip install -e .

Step 3: Make the wrapper script executable

chmod +x bin/cinema4d-mcp-wrapper

Step 4: Run the MCP server (example)

python3 main.py

Note: The Claude Desktop integration can be configured with development settings pointing to a local Python script as shown in the README. For published deployment, you would point Claude to the wrapper script provided in your environment.

Tips and notes:

• Ensure Cinema 4D’s Socket Server Plugin is running and configured to accept incoming MCP commands.
• If you encounter module import errors, install the MCP package system-wide: pip install mcp.
• For debugging, you can start the wrapper directly to validate connectivity: cinema4d-mcp-wrapper.
• If Claude Desktop cannot see MCP tools, verify the Claude Desktop configuration under Developer > Edit Config and ensure the mcpServers.cinema4d entry points to your Python script or wrapper.
• The tool catalog includes a wide range of commands (scene info, object creation, transforms, materials, MoGraph, dynamics, rendering, etc.). Use the MCP Inspector via the provided CLI to explore and test commands interactively.
• Rendering can fail at high resolutions due to memory constraints; prefer quick previews or smaller render settings when testing via MCP.