Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • ERPNext MCP Server
  • Powertools MCP Search Server
  • jcrawl4ai-mcp-server
  • Image Generation MCP Server
  • MCP Pokemon Server
Back to MCP Servers
Cinema4D MCP Server

Cinema4D MCP Server

Public
ttiimmaacc/cinema4d-mcp

Connect 3D design software to AI-powered prompt-assisted manipulation using a Python-based Model Context Protocol server enabling seamless command execution and integration for enhanced 3D workflow automation.

python
0 tools
May 29, 2025
Updated Jun 4, 2025

Supercharge Your AI with Cinema4D MCP Server

MCP Server

Unlock the full potential of Cinema4D MCP Server through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available β€’ No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

Cinema4D MCP β€” Model Context Protocol (MCP) Server

Cinema4D MCP Server connects Cinema 4D to Claude, enabling prompt-assisted 3D manipulation.

Table of Contents

  • Components
  • Prerequisites
  • Installation
  • Setup
  • Usage
  • Development
  • Troubleshooting & Debugging
  • File Structure
  • Tool Commands

Components

  1. C4D Plugin: A socket server that listens for commands from the MCP server and executes them in the Cinema 4D environment.
  2. MCP Server: A Python server that implements the MCP protocol and provides tools for Cinema 4D integration.

Prerequisites

  • Cinema 4D (R2024+ recommended)
  • Python 3.10 or higher (for the MCP Server component)

Installation

To install the project, follow these steps:

Clone the Repository

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

Install the MCP Server Package

pip install -e .

Make the Wrapper Script Executable

chmod +x bin/cinema4d-mcp-wrapper

Setup

Cinema 4D Plugin Setup

To set up the Cinema 4D plugin, follow these steps:

  1. Copy the Plugin File: Copy the c4d_plugin/mcp_server_plugin.pyp file to Cinema 4D's plugin folder. The path varies depending on your operating system:

    • macOS: /Users/USERNAME/Library/Preferences/Maxon/Maxon Cinema 4D/plugins/
    • Windows: C:\Users\USERNAME\AppData\Roaming\Maxon\Maxon Cinema 4D\plugins\
  2. Start the Socket Server:

    • Open Cinema 4D.
    • Go to Extensions > Socket Server Plugin
    • You should see a Socket Server Control dialog window. Click Start Server.

Claude Desktop Configuration

To configure Claude Desktop, you need to modify its configuration file:

  1. Open the Configuration File:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Alternatively, use the Settings menu in Claude Desktop (Settings > Developer > Edit Config).
  2. Add MCP Server Configuration: For development/unpublished server, add the following configuration:

    "mcpServers": { "cinema4d": { "command": "python3", "args": ["/Users/username/cinema4d-mcp/main.py"] } }
  3. Restart Claude Desktop after updating the configuration file.

[TODO] For published server

{ "mcpServers": { "cinema4d": { "command": "cinema4d-mcp-wrapper", "args": [] } } }

Usage

  1. Ensure the Cinema 4D Socket Server is running.
  2. Open Claude Desktop and look for the hammer icon πŸ”¨ in the input box, indicating MCP tools are available.
  3. Use the available Tool Commands to interact with Cinema 4D through Claude.

Testing

Command Line Testing

To test the Cinema 4D socket server directly from the command line:

python main.py

You should see output confirming the server's successful start and connection to Cinema 4D.

Testing with MCP Test Harness

The repository includes a simple test harness for running predefined command sequences:

  1. Test Command File (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.

  2. GUI Test Runner (tests/mcp_test_harness_gui.py): A simple Tkinter GUI for running the test commands:

    python tests/mcp_test_harness_gui.py

    The GUI allows you to:

    • Select a JSONL test file
    • Run the commands in sequence
    • View the responses from Cinema 4D

This test harness is particularly useful for:

  • Rapidly testing new commands
  • Verifying plugin functionality after updates
  • Recreating complex scenes for debugging
  • Testing compatibility across different Cinema 4D versions

Troubleshooting & Debugging

  1. Check the log files:

    tail -f ~/Library/Logs/Claude/mcp*.log
  2. Verify Cinema 4D shows connections in its console after you open Claude Desktop.

  3. Test the wrapper script directly:

    cinema4d-mcp-wrapper
  4. If there are errors finding the mcp module, install it system-wide:

    pip install mcp
  5. For advanced debugging, use the MCP Inspector:

    npx @modelcontextprotocol/inspector uv --directory /Users/username/cinema4d-mcp run cinema4d-mcp

Project File Structure

cinema4d-mcp/
β”œβ”€β”€ .gitignore
β”œβ”€β”€ LICENSE
β”œβ”€β”€ README.md
β”œβ”€β”€ main.py
β”œβ”€β”€ pyproject.toml
β”œβ”€β”€ setup.py
β”œβ”€β”€ bin/
β”‚   └── cinema4d-mcp-wrapper
β”œβ”€β”€ c4d_plugin/
β”‚   └── mcp_server_plugin.pyp
β”œβ”€β”€ src/
β”‚   └── cinema4d_mcp/
β”‚       β”œβ”€β”€ __init__.py
β”‚       β”œβ”€β”€ server.py
β”‚       β”œβ”€β”€ config.py
β”‚       └── utils.py
└── tests/
    β”œβ”€β”€ test_server.py
    β”œβ”€β”€ mcp_test_harness.jsonl
    └── mcp_test_harness_gui.py

Tool Commands

General Scene & Execution

  • 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.). βœ…

Object Creation & Modification

  • 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. βœ…

Cameras & Animation

  • create_camera: Add a new camera to the scene. βœ…
  • animate_camera: Animate a camera along a path (linear or spline-based). βœ…

Lighting & Materials

  • 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. βœ…

Redshift Support

  • validate_redshift_materials: Check Redshift material setup and connections. βœ… ⚠️ (Redshift materials not fully implemented)

MoGraph & Fields

  • 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. βœ…

Dynamics & Physics

  • create_soft_body: Add a Soft Body tag to an object. βœ…
  • apply_dynamics: Apply Rigid or Soft Body physics. βœ…

Rendering & Preview

  • 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). βœ…

Compatibility Plan & Roadmap

Cinema 4D VersionPython VersionCompatibility StatusNotes
R21 / S22Python 2.7❌ Not supportedLegacy API and Python version too old
R23Python 3.7πŸ” Not plannedNot currently tested
S24 / R25 / S26Python 3.9⚠️ Possible (TBD)Requires testing and fallbacks for missing APIs
2023.0 / 2023.1Python 3.9πŸ§ͺ In progressTargeting fallback support for core functionality
2023.2Python 3.10πŸ§ͺ In progressAligns with planned testing base
2024.0Python 3.11βœ… SupportedVerified
2025.0+Python 3.11βœ… Fully SupportedPrimary development target

Compatibility Goals

  • Short Term: Ensure compatibility with C4D 2023.1+ (Python 3.9 and 3.10)
  • Mid Term: Add conditional handling for missing MoGraph and Field APIs
  • Long Term: Consider optional legacy plugin module for R23–S26 support if demand arises

Recent Fixes

  • Context Awareness: Implemented robust object tracking using GUIDs. Commands creating objects return context (guid, actual_name, etc.). Subsequent commands correctly use GUIDs passed by the test harness/server to find objects reliably.
  • Object Finding: Reworked find_object_by_name to correctly handle GUIDs (numeric string format), fixed recursion errors, and improved reliability when doc.SearchObject fails.
  • GUID Detection: Command handlers (apply_material, create_mograph_cloner, add_effector, apply_mograph_fields, set_keyframe, group_objects) now correctly detect if identifiers passed in various parameters (object_name, target, target_name, list items) are GUIDs and search accordingly.
  • create_mograph_cloner: Fixed AttributeError for missing MoGraph parameters (like MG_LINEAR_PERSTEP) by using getattr fallbacks. Fixed logic bug where the found object wasn't correctly passed for cloning.
  • Rendering: Fixed TypeError in render_frame related to doc.ExecutePasses. snapshot_scene now correctly uses the working base64 render logic. Large render_frame still faces memory limits.
  • Registration: Fixed AttributeError for c4d.NilGuid.
Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • ERPNext MCP Server
    ERPNext MCP Server

    Model Context Protocol server enabling seamless integration with ERPNext via API, offering authentic...

    Added May 30, 2025
  • Powertools MCP Search Server
    Powertools MCP Search Server

    Model Context Protocol server enabling efficient local search of AWS Lambda Powertools documentation...

    2 tools
    Added May 30, 2025
  • jcrawl4ai-mcp-server
    jcrawl4ai-mcp-server

    Java-based Model Context Protocol server enabling web crawling via Crawl4ai API with configurable st...

    Added May 30, 2025
  • Image Generation MCP Server
    Image Generation MCP Server

    Enables high-quality image generation via Model Context Protocol with customizable dimensions, promp...

    1 tools
    Added May 30, 2025
  • MCP Pokemon Server
    MCP Pokemon Server

    An MCP server implementation enabling interaction with the PokeAPI to fetch dynamic PokΓ©mon data and...

    Added May 30, 2025