关键词

BlenderAIMCP3D建模自动化

Blender MCP 使用说明

项目简介

Blender MCP 项目实现了 Model Context Protocol (MCP) 与 Blender 的集成，构建了一个 MCP 服务器，使得支持 MCP 协议的 AI 客户端（例如 Claude）能够通过标准化的方式访问 Blender 的功能和场景数据。该项目包含独立的 MCP 服务器核心和 Blender 插件两部分，通过进程间通信 (IPC) 协同工作，为 AI 驱动的 3D 内容创作提供了一个强大的工具。

主要功能点

  • 资源访问: 允许 AI 查看和访问 Blender 场景中的各种资源，如对象、材质、灯光和相机，并获取资源的详细信息。
  • 工具操作: 提供一系列工具，使 AI 能够控制 Blender 执行各种操作，包括创建 3D 对象、设置材质、调整灯光、配置相机、渲染场景、应用修改器、对象变换和导入外部模型等。
  • 提示模板: 预置了场景创建、动画制作和材质教程等提示模板，帮助用户快速上手并指导 AI 进行更复杂的 Blender 操作。
  • 进程分离架构: MCP 服务器核心与 Blender 插件分离，保证了服务器的稳定性和性能，并解决了 Blender Python 环境的限制问题。

安装步骤

  1. 克隆仓库

    git clone https://github.com/xiguadaddy/blender_mcp_new.git
cd blender_mcp_new

  2. 安装 MCP 服务器核心依赖

    cd mcp-server
pip install -r requirements.txt

  3. 安装 Blender 插件

    • 启动 Blender (Blender 3.0 或更高版本)。
    • 进入 '编辑' > '首选项' > '附加组件'。
    • 点击 '安装...' 按钮，选择 'blender-addon' 目录生成的 ZIP 文件（通常需要先在 'blender-addon' 目录手动压缩）。
    • 在附加组件列表中勾选 'Blender MCP' 以激活插件。

服务器配置

为了让 MCP 客户端（如 Claude）连接到 Blender MCP 服务器，您需要在客户端配置中添加服务器信息。以下是 Claude 客户端的配置示例，您需要根据实际情况修改 '/path/to/blender-mcp_new/start_server.py' 为 'start_server.py' 脚本的绝对路径：

{
  "mcpServers": {
    "blender": {
      "command": "python",
      "args": ["/path/to/blender-mcp_new/start_server.py"]
      // "command": "python"  // 启动服务器的命令，通常为 python
      // "args": ["/path/to/blender-mcp_new/start_server.py"] // 启动脚本的路径，请替换为实际路径
    }
  }
}

基本使用方法

  1. 启动 Blender 插件服务器

    • 打开 Blender，在 3D 视图的侧边栏中找到 'MCP' 标签。
    • 点击 '启动服务器' 按钮，启动 Blender 插件内部的 IPC 服务器。

  2. 启动 MCP 服务器核心

    • 打开终端，进入 'blender_mcp_new' 仓库的根目录。
    • 运行命令 'python start_server.py' 启动独立的 MCP 服务器核心进程。

  3. 配置并使用 MCP 客户端

    • 根据 MCP 客户端（如 Claude）的文档配置连接到 Blender MCP 服务器。
    • 通过 MCP 客户端发送指令，例如：'我想在场景中创建一个蓝色球体'，即可与 Blender 进行交互。

注意事项

  • 确保 Blender 版本为 3.0 或更高，Python 版本为 3.7 或更高。
  • Windows 平台下，IPC 通信路径可能需要使用命名管道或端口号。
  • 首次使用可能需要等待服务器启动完成。
  • 详细的调试和测试功能可以在 Blender 插件的 'MCP' 面板中找到。

信息

分类

桌面与硬件

访问项目