Blender自然语言控制工具

Blender MCP VXAI是一个强大的集成工具,允许用户通过自然语言控制Blender,实现3D模型的创建、修改和场景管理,适用于从初学者到经验丰富的用户。

  • by VxASI
  • Python
  • 本地部署
  • 300 星标
  • 更新于
在 GitHub 查看 VxASI/blender-mcp-vxai

使用说明

搅拌机MCP VXAI

专业提示:您可以使用此功能要求您的代理将3d模型直接导出到您正在处理的项目中,以便在您的应用程序中立即使用它们。 演示

描述

Blender MCP VXAI是一个强大的集成,允许您通过MCP客户端使用自然语言控制Blender。此工具使您能够在Blender中创建、修改和操纵3D模型、动画和场景,只需简单地描述您想做什么。它弥合了AI语言模型和3D创建之间的差距,使Blender对初学者和有经验的用户来说都更容易使用和高效。这是一个简单的工具,代理可以让AI代理为您创建脚本,同时获得反馈并构建您想要的确切场景。

重要提示:
如果您正在使用 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 注意:使用新的插件文件重复插件步骤,并从以下位置更新MCP服务器 uv 如果需要的话。查看发行说明了解更多详细信息 演示.


入门:构建你的3D世界

第一步:准备好你的形象

  • 基金会: 从一个基本图像开始,作为项目的基础。

第二步:上传您的图片

  • 选择您的MCP客户端: 将您的图像加载到任何MCP客户端,例如 光标, 克莱恩,或 帆板运动.

第三步:定义你的创意提示

  • 示例提示:
    Create this in 3D. I've given you my insane architectural plans—make it as pretty as you can! :)
    
  • 愿景: 用自然语言描述你的概念,看着你的视觉变成3D场景。

第四步:用自然语言精炼

  • 迭代: 继续用简单的英语完善你的场景,直到它完全符合你的视觉。

步骤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创作无缝整合到您的交互式应用程序中。

第六步:体验与提升

  • 探索: 在完全实现的3D世界中享受和导航。
  • 波兰语: 应用最后的调整来增强您的创作的美感和功能性。

特性

  • 自然语言命令: 用日常语言轻松控制Blender。
  • 无缝MCP集成: 在您首选的MCP客户中工作。
  • 人工智能驱动的自动化: 使用智能文本指令简化复杂的3D操作。
  • 增强的工作流程: 借助前瞻性思维的人工智能辅助,改变您的创作过程。

安装

先决条件

  • 搅拌机
  • Python 3.8+

第一步:安装UV

UV对于运行MCP服务器至关重要。

  • macOS:
    brew install uv
    
  • Windows/Linux:
    pip install uv
    

步骤2:配置您的环境

对于最新版本,请使用以下命令: uvx blender-mcp-vxai (您不需要输入==版本号)

对于光标:

  1. 点击 “+添加新服务器”.
  2. 配置为:
    • 姓名: blender-mcp
    • 命令: uvx blender-mcp-vxai==1.0.7

对于Claude Desktop:

  1. 首选 Claude>设置>开发人员>编辑配置.
  2. 打开 claude_desktop_config.json 并添加:
    {
        "mcpServers": {
            "blender": {
                "command": "uvx",
                "args": [
                    "blender-mcp-vxai==1.0.7"
                ]
            }
        }
    }
    

步骤3:安装Blender插件

  1. 下载: 拿到 blender_mcp_addon.py 文件。
  2. 打开搅拌机: 引导到 编辑>首选项>附加组件.
  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探索、创造和创新。