Cinema4D MCP Server 使用说明

项目简介

Cinema4D MCP Server 是一个基于 Model Context Protocol (MCP) 协议构建的服务器，旨在连接 Cinema 4D 和 Claude 等 LLM 客户端，通过自然语言指令控制 Cinema 4D 进行 3D 建模和渲染等操作。它包含一个 Python MCP 服务器和一个 Cinema 4D 插件，协同工作，允许用户使用 Claude 与 Cinema 4D 场景进行交互。

主要功能点

3D 场景控制: 通过自然语言指令，在 Claude 中直接控制 Cinema 4D 软件，实现 3D 场景的编辑和操作。
丰富的工具集: 提供创建、修改和查询 Cinema 4D 场景元素的工具，例如添加几何体、调整对象属性、应用材质、渲染场景等。
LLM 客户端集成: 专为与 Claude 等 LLM 客户端集成设计，利用自然语言处理能力简化 3D 内容创作流程。
扩展性: 基于 MCP 协议，易于扩展新的 Cinema 4D 功能和工具，满足用户定制化需求。

安装步骤

克隆仓库:

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

安装 Python 包:
```
pip install -e .
```

使 wrapper 脚本可执行:

chmod +x bin/cinema4d-mcp-wrapper

安装 Cinema 4D 插件:
- 复制 'c4d_plugins/mcp_server_plugin.pyp' 文件到 Cinema 4D 的插件目录。
  - macOS: '/Users/USERNAME/Library/Preferences/Maxon/Maxon Cinema 4D/plugins/'
  - Windows: 'C:\Users\USERNAME\AppData\Roaming\Maxon\Maxon Cinema 4D/plugins'

服务器配置

要配置 Claude Desktop 连接到 Cinema4D MCP Server，需要在 Claude Desktop 的配置文件 'claude_desktop_config.json' 中添加 MCP 服务器配置。

开发环境配置示例

{
  "mcpServers": {
    "cinema4d": {
      "command": "python3",
      "args": ["/Users/username/cinema4d-mcp/main.py"]
    }
  }
}

配置参数说明:

'"cinema4d"': 服务器名称，用户自定义，用于在 Claude Desktop 中标识该 MCP 服务器连接。
'"command"': 启动 Cinema4D MCP Server 的命令，指定 Python 3 解释器 'python3'。
'"args"': 启动命令的参数，指向 'main.py' 脚本的路径。请务必将 '/Users/username/cinema4d-mcp/main.py' 替换为实际仓库在您电脑上的路径。

发布环境配置示例

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