Cinema4D MCP — Model Context Protocol (MCP) Server - MCP服务，MCP服务器，MCP教程

基本能力

产品定位

Cinema4D MCP Server 旨在通过 AI 辅助简化 Cinema 4D 的 3D 建模和动画制作流程，提高开发效率和创作自由度。

核心功能

1. 场景与执行：获取场景信息、列出对象、执行 Python 代码、保存/加载场景等。
2. 对象创建与修改：添加基本几何体、修改对象属性、创建抽象形状等。
3. 相机与动画：创建相机、沿路径动画相机等。
4. 灯光与材质：添加灯光、创建和应用材质/着色器等。
5. MoGraph 与场：创建克隆器、添加效应器、应用场等。
6. 动力学与物理：创建软体、应用刚体/软体物理等。
7. 渲染与预览：渲染帧、快速预览、场景快照等。

适用场景

• 快速原型设计
• 自动化 3D 场景构建
• AI 辅助动画制作
• 材质和灯光测试
• 教学和演示

工具列表

1. get_scene_info：获取场景摘要信息。
2. list_objects：列出所有场景对象（带层次结构）。
3. add_primitive：向场景添加基本几何体。
4. create_camera：添加新相机。
5. create_light：添加灯光。
6. create_material：创建标准材质。
7. render_preview：渲染快速预览并返回 base64 图像。
8. create_mograph_cloner：添加 MoGraph 克隆器。
9. create_soft_body：添加软体标签。

常见问题解答

1. 插件未加载：检查插件是否复制到正确的 Cinema 4D 插件文件夹。
2. 连接问题：确保 Cinema 4D 的 Socket Server 正在运行。
3. 模块未找到：尝试全局安装 mcp 模块（pip install mcp）。
4. 调试：使用 tail -f ~/Library/Logs/Claude/mcp*.log 查看日志。

使用教程

使用依赖

• Cinema 4D
• Python 3.10 或更高版本

安装教程

1. 克隆仓库：
   bash
git clone https://github.com/ttiimmaacc/cinema4d-mcp.git
cd cinema4d-mcp
2. 安装包：
   bash
pip install -e .
3. 使包装脚本可执行：
   bash
chmod +x bin/cinema4d-mcp-wrapper

Cinema 4D 插件设置

1. 将 c4d_plugin/mcp_server_plugin.pyp 复制到 Cinema 4D 的插件文件夹。
2. 在 Cinema 4D 中启动 Socket Server（Extensions > Socket Server Plugin > Start Server）。

Claude 桌面配置

1. 修改 Claude 桌面配置文件，添加 MCP Server 配置：
   json
"mcpServers": {
"cinema4d": {
"command": "python3",
"args": ["/Users/username/cinema4d-mcp/main.py"]
}
}
2. 重启 Claude Desktop。

调试方式

1. 测试服务器：
   bash
python main.py
2. 使用测试工具：
   bash
python tests/mcp_test_harness_gui.py
3. 高级调试：
   bash
npx @modelcontextprotocol/inspector uv --directory /Users/username/cinema4d-mcp run cinema4d-mcp