Blender

Blender MCP VXAI

专业提示：你可以让你的 Agent 将 3D 模型直接导出到当前项目中，以便立即在应用中使用。演示

描述

Blender MCP VXAI 是一款强大的集成工具，可让你通过 MCP 客户端使用自然语言控制 Blender。只需描述你想做什么，此工具便能帮你在 Blender 中创建、修改和操作 3D 模型、动画和场景。它弥合了 AI 大模型与 3D 创作之间的鸿沟，让初学者和经验丰富的用户都能更轻松、高效地使用 Blender。这是一款简单的工具，Agent 可以让 AI Agent 为你编写脚本，同时接收反馈并构建你想要的准确场景。

重要提示：
如果你使用 uvx blender-mcp-vxai，请确保使用仓库中的最新插件文件。否则，请确保使用正确的版本。大多数配置应使用 1.0.5 版本，不过目前可用的最新版本是 1.0.7。

• 如需获取确切的文件，请前往 https://github.com/VxASI/blender-mcp-vxai/tree/v1.0.7（将版本替换为你需要的版本），然后下载该插件文件。

加入 Discord 社区

Discord 链接

• 提问
• 提出建议
• 反馈
• 快速响应

概览

Blender MCP VXAI 弥合了 AI 与 3D 建模之间的鸿沟。无论你是经验丰富的艺术家还是刚刚入门，现在都可以：

• 实时创建和修改： 使用自然语言指示 Blender 构建或修改内容。
• 简化工作流： 自动执行复杂操作，并立即获得视觉反馈。
• 即时导出： 将 3D 模型直接集成到应用或项目中。

最新版本： v1.0.7 注意：使用新的插件文件重复插件安装步骤，并根据需要从 uv 更新 MCP 服务。更多详情请查看发行说明 演示。

---

开始使用：构建你的 3D 世界

第 1 步：准备图像

• 基础： 从一张基本图像开始，将其用作项目的基础。

第 2 步：上传图像

• 选择 MCP 客户端： 将图像加载到任意 MCP 客户端中，例如 Cursor、Cline 或 Windsurf。

第 3 步：定义创意提示词

• 提示词示例：

  Create this in 3D. I've given you my insane architectural plans—make it as pretty as you can! :)
  

• 构想： 用自然语言描述你的构想，看着它变成 3D 场景。

第 4 步：使用自然语言进行完善

• 迭代： 继续用通俗英语完善场景，直到它与你的构想完全一致。

第 5 步：导出并集成

• 命令提示符：

  Export this scene in this project in .gib format, then create a ThreeJS app and use this as my world. Set it up as a server to avoid file-loading issues. I want to roam around this world freely—go wild!
  

• 集成： 将你的 3D 创作无缝融入交互式应用。

第 6 步：体验并增强

• 探索： 尽情体验并探索你完整构建的 3D 世界。
• 润色： 进行最后的调整，提升作品的美观度和功能性。

---

功能

• 自然语言命令： 使用日常语言轻松控制 Blender。
• 无缝 MCP 集成： 在你偏好的 MCP 客户端中工作。
• AI 驱动的自动化： 通过智能文本指令简化复杂的 3D 操作。
• 增强工作流： 借助前瞻性的 AI 助手，改变你的创作流程。

---

安装

前置条件

• Blender
• Python 3.8+

第 1 步：安装 UV

运行 MCP 服务需要 UV。

• macOS：

  brew install uv
  

• Windows/Linux：

  pip install uv
  

第 2 步：配置环境

如需使用最新版本，请运行命令：uvx blender-mcp-vxai（无需填写 == 版本号）

对于 Cursor：

1. 点击 "+ Add new Server"。
2. 配置以下内容：
   • 名称： blender-mcp
   • 命令： uvx blender-mcp-vxai==1.0.7

对于 Claude Desktop：

1. 前往 Claude > Settings > Developer > Edit Config。
2. 打开 claude_desktop_config.json 并添加：

   {
       "mcpServers": {
           "blender": {
               "command": "uvx",
               "args": [
                   "blender-mcp-vxai==1.0.7"
               ]
           }
       }
   }
   

步骤 3：安装 Blender 插件

1. 下载： 获取 blender_mcp_addon.py 文件。
2. 打开 Blender： 前往 编辑 > 首选项 > 插件。
3. 安装插件： 点击“从磁盘安装”，然后选择 blender_mcp_addon.py 文件。
4. 启用： 勾选“Blender MCP”旁边的复选框以启用它。
5. 启动 MCP 服务： 在 Blender 的 3D 视图侧栏中（如果隐藏，请按 N），打开“BlenderMCP”标签页并启动 MCP 服务。

---

用法与工具

可用工具：

• 对象创建： 生成基本图元、导入模型或设计复杂形状。
• 建模： 修改网格、应用修改器并精确雕刻。
• 材质： 创建和分配纹理、着色器与材质。
• 动画： 设置关键帧、制作属性动画并配置绑定。
• 渲染： 优化灯光、相机设置和渲染设置。
• 场景管理： 高效整理对象、集合和整个场景。

示例用例：

• 将图像转换为低多边形 3D 版本。
• 使用详细的自然语言描述动态更新场景元素。
• 逐步构建场景，并调整相机角度、颜色、灯光等。

---

故障排除

• 服务问题： 如果遇到连接问题，请确认 MCP 服务正在运行。
• 插件检查： 确认 Blender 插件已正确安装并启用。
• 错误诊断： 如需查看详细错误消息，请检查 Blender 控制台。

对于 1.0.3 及更早版本，请使用以下命令：

uvx --from blender-mcp-vxai start

---

贡献

欢迎为 Blender MCP VXAI 贡献力量，让它更具创新性。请提交 Pull Request，加入我们富有远见的社区。

许可证

详情请参阅 LICENSE 文件。

---

拥抱 3D 建模的未来——使用 Blender MCP VXAI 探索、创作与创新。