关键词

3D建模Blender控制自然语言交互场景操作Python脚本

使用说明

项目简介

Blender MCP VXAI Server 是一个 MCP (Model Context Protocol) 服务器，它允许你使用自然语言通过 MCP 客户端控制 Blender 软件。通过这个工具，你可以使用文本指令创建、修改和操作 Blender 中的 3D 模型、动画和场景。它充当连接大型语言模型 (LLM) 和 Blender 3D 创作软件的桥梁，使得 3D 内容的生成和编辑更加直观和高效。

主要功能点

  • 场景信息查询: 允许 MCP 客户端查询 Blender 场景中的各种信息，例如物体列表、物体属性（位置、旋转、缩放、顶点数据等），并支持根据类型、名称、空间范围等条件进行过滤查询。
  • Python 脚本执行: 允许 MCP 客户端发送 Python 脚本到 Blender 中执行，从而实现对 Blender 场景的编程控制，包括物体创建、修改、动画制作、渲染设置等高级操作。

安装步骤

  1. 安装 Blender: 确保你的电脑上已安装 Blender 软件。
  2. 安装 Python: 确保你的电脑上已安装 Python 3.8 或更高版本。
  3. 安装 UV: 根据你的操作系统，使用 'brew install uv' (macOS) 或 'pip install uv' (Windows/Linux) 安装 UV 包管理器。
  4. 下载 Blender 插件: 下载仓库中的 'blender_mcp_addon.py' 文件。
  5. 安装 Blender 插件:
    • 打开 Blender，进入 “编辑” (Edit) -> “偏好设置” (Preferences) -> “插件” (Add-ons)。
    • 点击 “安装...” (Install...)，选择下载的 'blender_mcp_addon.py' 文件并安装。
    • 启用名为 “Blender MCP” 的插件。
  6. 启动 MCP 服务器:
    • 在 Blender 窗口的 3D 视图侧边栏 (按 N 键显示/隐藏)，打开 “BlenderMCP” 选项卡。
    • 点击 “Start MCP Server” 按钮启动 Blender 内部的 MCP 服务器。
    • 克隆或下载 'blender-mcp-vxai' 仓库到本地。
    • 进入 'blender-mcp-vxai' 目录。
    • 运行命令 'uvx blender-mcp-vxai' 启动外部 MCP 服务器。

服务器配置

对于 MCP 客户端，你需要配置连接到 Blender MCP VXAI Server。以下是 MCP 客户端需要配置的服务器信息，通常在 MCP 客户端的设置或配置界面中添加新的服务器连接时使用。

MCP 服务器配置信息 (JSON 格式示例):

{
    "server name": "blender-mcp",  //  服务器名称，可以自定义，用于在客户端中标识该服务器
    "command": "uvx",             //  启动 MCP 服务器的命令，通常是 uvx 或其他可以执行 Python 包的命令
    "args": [                      //  传递给启动命令的参数列表
        "blender-mcp-vxai"      //  指定要运行的 MCP 服务器包名，这里是 blender-mcp-vxai
    ]
}

基本使用方法

  1. 确保 Blender 软件已打开，并且 Blender 内部的 MCP 服务器和外部 MCP 服务器都已成功启动。
  2. 在 MCP 客户端（如 Cursor, Cline, Windsurf 等兼容 MCP 协议的客户端）中，根据客户端的使用说明，配置并连接到名为 "blender-mcp" (或你在配置中自定义的服务器名称) 的 MCP 服务器。
  3. 连接成功后，在 MCP 客户端的交互界面中，可以使用自然语言指令，通过配置的 MCP 服务器与 Blender 进行通信，控制 Blender 进行各种 3D 场景操作。例如，你可以发送指令创建新的 3D 物体、修改现有物体的属性、或者执行复杂的场景操作。

注意: Blender 内部的 MCP 服务器和外部 MCP 服务器都需要启动才能正常工作。Blender 内部的服务器作为插件运行，负责接收和执行外部 MCP 服务器发送的指令。外部 MCP 服务器则作为 MCP 客户端和 Blender 插件服务器之间的桥梁。

信息

分类

桌面与硬件

访问项目