Blender AI代理3D建模工具

该工具允许AI代理使用Blender开源3D建模和渲染软件,根据用户需求自动创建有机和自然的3D几何模型。

  • by blwfish
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 blwfish/blender-mcp

使用说明

搅拌机mcp

此工具使您的AI代理能够使用 搅拌机 --开源3D建模和渲染软件——为您创建有机自然的3D几何体。

这有什么作用

你描述你需要什么——“为我的场景建模一棵树”或“用河床创建地形”——剩下的工作由你的AI代理完成:编写Blender Python脚本、操纵网格、检查可打印性,以及导出到STL/OBJ/3MF。Blender擅长有机几何:树木、人物、地形特征、岩壁以及任何网格建模闪耀的地方。

你不需要知道Blender。你不需要知道网格建模意味着什么。你只需要一个AI代理(比如 克劳德).

入门指南

告诉你的AI代理:

首选https://github.com/blwfish/blender-mcp并读取AGENT-INSTALL.md文件。按照说明在此计算机上安装和配置Blender MCP服务器。

你的代理将处理其余的事情——安装先决条件、克隆仓库、设置Blender插件和注册自己。设置完成后,您可以要求您的代理创建3D模型。

你可以要求你的代理人做什么

  • 创建3D模型 --“模拟一棵约50英尺高、分枝逼真的松树”
  • 雕刻地形 --“用河床和一些散落的岩石建造一个山坡”
  • 准备3D打印 --“检查此模型是否可打印,并将其以HO比例导出为STL”
  • 使用现有模型 --“导入此STL并向曲面添加细节”
  • 使用Blender插件 --“使用TheGrove种植一棵逼真的橡树”(如果已安装)

背景

我为自己建造了这个。我在Mac上使用克劳德代码。其他平台 应该 工作,但测试较少。将考虑其他代理和平台的PR。

对于开发者

# 86 tests, no Blender required
pytest tests/test_protocol.py tests/test_server.py tests/test_debug.py -v

看 代理安装.md 了解完整的技术细节、架构、贡献指南以及如何添加新工具。

安全

此MCP服务器授予您的AI代理对Blender Python环境的完全访问权限,包括通过以下方式运行任意代码的能力 execute_blender_code这是设计出来的——这就是这个工具有用的地方。但是,您应该意识到其中的含义:

  • 任意代码执行:The execute_blender_code 该工具可以在Blender中运行任何Python代码,并完全访问文件系统、网络和操作系统。这相当于给你的AI代理一个shell。
  • 无限制的文件访问:网格导入/导出操作接受任意文件系统路径。代理可以读取和写入您的用户帐户可以访问的任何文件。
  • 本地主机TCP:MCP服务器通过TCP与Blender插件通信 127.0.0.1:9876。它不暴露于网络,但任何本地进程都可以连接到此端口。
  • 无身份验证:TCP通道没有共享密钥或令牌。在单用户工作站上,这很好;在共享系统上,请注意其他本地用户也可以连接。

此工具旨在用于单用户计算机上的本地开发。 不要将其暴露给不受信任的网络或用户。

许可证

麻省理工学院