返回 MCP 目录
public公开dns本地运行

blender

BlenderMCP通过MCP协议将Blender与Claude AI连接,实现AI辅助3D建模与场景控制

article

README

🚀 BlenderM 免费AI 3D建模助手

BlenderM 是一款免费的 AI 3D 建模助手,它集成了多种工具和 API(如 PolyHaven 和 Hyper3D),能助力用户迅速打造高质量的 3D 场景。用户可借助自然语言指令生成模型、材质和设置光照,还能下载 HDR 环境与高保真资产。

🚀 快速开始

系统要求

  • 操作系统: Windows (64-bit) / macOS / Linux (64-bit)
  • Blender 版本: 3.5+

安装步骤

  1. 下载并安装最新版本的 Blender。
  2. 在 Blender 的 -addon 包管理器中启用 BlendeR - M 插件。

快速上手

  1. 启动 Blender 并打开 BlendeR - M 插件界面。
  2. 连接 AI 服务(确保网络连接正常)。
  3. 输入自然语言指令,例如:“创建一个古堡场景,带有中世纪风格的建筑和魔法阵”。

示例命令

  • "生成一个低多边形的奇幻森林场景"
  • "将所有模型材质改为金属质感"
  • "设置场景光照为电影级别的灯光布局"

✨ 主要特性

  • AI 驱动建模:使用自然语言指令创建复杂场景。
  • 资产下载:直接从 PolyHaven 下载专业级模型和材质。
  • HDR 环境支持:一键式 HDR 环境应用,提升渲染效果。
  • 材质编辑:自动生成和编辑模型材质。
  • 光照设置:智能配置场景光照,适应不同创作需求。

📦 安装指南

系统要求

| 属性 | 详情 | | ---- | ---- | | 操作系统 | Windows (64 - bit) / macOS / Linux (64 - bit) | | Blender 版本 | 3.5+ |

安装步骤

  1. 下载并安装最新版本的 Blender。
  2. 在 Blender 的 -addon 包管理器中启用 BlendeR - M 插件。

💻 使用示例

基础用法

# 启动 Blender 并打开 BlendeR - M 插件界面
# 连接 AI 服务(确保网络连接正常)
# 输入自然语言指令,例如:“创建一个古堡场景,带有中世纪风格的建筑和魔法阵”

高级用法

# 可以组合使用多个指令,实现更复杂的场景创建。例如先创建一个场景,再修改材质和光照。
# 输入指令:“创建一个现代城市街道场景”
# 接着输入:“将所有建筑模型材质改为玻璃质感”
# 最后输入:“设置场景光照为黄昏氛围的灯光布局”

📚 详细文档

Hyper3D 集成

Hyper3D 提供免费试用版,支持每天一定次数的 AI 模型生成。如需更多使用次数,请访问其官网购买正式许可。

故障排除

常见问题及解决方案:

  1. 连接失败:确保网络稳定,检查防火墙设置是否阻止了插件所需的端口。
  2. 超时错误:尝试简化指令或分步骤执行操作。
  3. 性能问题:建议在高性能计算环境中运行,确保硬件配置满足要求。

安全注意事项

  1. 代码执行风险:使用 execute_blender_code 工具时需谨慎,避免在生产环境中使用。
  2. 数据下载管理:确保关闭不需要的资产下载功能。

贡献指南

欢迎社区贡献!请通过提交 Pull Request 参与项目开发。

🔧 技术细节

通信协议

使用基于 JSON 的简单协议通过 TCP 套接字进行通信:

  • 请求:包含 type 和可选的 params
  • 响应:返回 status, resultmessage

📄 许可证

文档未提及相关许可证信息。

其他信息

加入社区

欢迎加入我们的 Discord 社区,与全球的 Blender 用户和 AI 3D 建模爱好者交流经验,分享创作心得!

支持者

  • PolyHaven:提供高质量的 3D 模型、材质和 HDR 环境。
  • Hyper3D:免费试用版支持每日有限次数的模型生成。

发行说明

版本更新日志

v1.0.0(2024年3月15日)

  • 初始版本发布,集成 PolyHaven 和 Hyper3D 服务。
  • 支持基本的 AI 模型生成和场景配置功能。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端