Blender

BlenderMCP 是一款基于 MCP 协议的 AI 驱动 3D 建模工具，通过将 Blender 与 Claude AI 连接，允许用户使用自然语言指令创建和控制 3D 场景。该工具支持对象操作、材质控制、场景信息获取、Python 脚本执行、Hyper3D 模型生成和 Poly Haven 资产下载等功能，适用于需要快速构建 3D 场景的设计人员、艺术家和开发者。

核心功能

BlenderMCP 提供了多种核心功能，帮助用户通过自然语言指令控制 Blender 环境，实现高效的 3D 建模与场景管理。主要功能包括：

• 双向通信：支持 Claude AI 与 Blender 之间的实时交互。
• 对象操作：创建、修改和删除 3D 对象。
• 材质控制：应用和调整材质及颜色。
• 场景信息获取：获取当前 Blender 场景的详细信息。
• Python 代码执行：在 Blender 中运行任意 Python 代码。
• Hyper3D 集成：通过 AI 生成 3D 模型。
• Poly Haven 资产下载：通过 API 获取高质量免费资产。

安装方法

安装 BlenderMCP 需要先安装 Blender，并启用插件。以下是详细步骤：

1. 下载并安装最新版本的 Blender（要求版本为 3.5+）。
2. 在 Blender 的插件管理器中启用 BlendeR - M 插件。
3. 确保在终端中启动 MCP 服务器，命令如下：

python src/blender_mcp/server.py

使用方法

BlenderMCP 的使用非常直观，用户只需通过自然语言指令即可控制 Blender 场景。以下是几个使用示例：

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

高级用法示例：

# 创建一个现代城市街道场景
"创建一个现代城市街道场景"

# 修改材质
"将所有建筑模型材质改为玻璃质感"

# 设置光照
"设置场景光照为黄昏氛围的灯光布局"

使用场景

BlenderMCP 适用于多种 3D 建模场景，包括但不限于：

• 快速构建低多边形风格的场景，如地牢、奇幻森林等。
• 通过 AI 生成模型并导入到 Blender 中。
• 下载 Poly Haven 提供的高质量模型和材质。
• 通过自然语言指令调整场景光照和材质。

注意事项

在使用 BlenderMCP 时，需要注意以下事项：

• 确保 Blender 和 Python 的版本兼容。
• 复杂操作可能需要分解为多个步骤执行。
• 某些功能（如 Hyper3D 模型生成）可能受每日使用配额限制。
• 使用 execute_blender_code 工具时需谨慎，避免在生产环境中使用。
• 确保关闭不需要的资产下载功能，以避免不必要的数据消耗。

使用示例

以下是两个典型的使用示例：

• 创建地牢场景：生成一个包含龙和金罐的地牢场景。
• 生成花园小矮人：使用 Hyper3D 生成 3D 模型。

示例指令如下：

"Create a low-poly dungeon scene with a dragon guarding a pot of gold."
"Generate a 3D model of a garden gnome through Hyper3D."

这些指令将触发 BlenderMCP 执行相应的建模和资源下载操作。

通信协议

BlenderMCP 使用基于 JSON 的简单协议通过 TCP 套接字进行通信，格式如下：

{
  "type": "command_name",
  "params": {
    "key": "value"
  }
}

响应格式如下：

{
  "status": "success",
  "result": "operation_result",
  "message": "optional_message"
}

这种通信方式确保了 Blender 与 AI 服务之间的高效交互。

BlenderMCP 通过自然语言指令和 AI 驱动的建模能力，为 3D 设计人员和开发者提供了一种全新的创作方式，使复杂场景的构建变得更加直观和高效。