{/* 此页面由 website/scripts/generate-skill-docs.py 从技能的 SKILL.md 自动生成。请编辑源文件 SKILL.md，而非此页面。 */}
Blender MCP
通过套接字连接至 blender-mcp 插件，直接从 Hermes 控制 Blender。创建 3D 物体、材质、动画，并运行任意 Blender Python（bpy）代码。当用户想在 Blender 中创建或修改任何内容时使用。
技能元数据
| 来源 | 可选 —— 使用 hermes skills install official/creative/blender-mcp 安装 |
| 路径 | optional-skills/creative/blender-mcp |
| 版本 | 1.0.0 |
| 作者 | alireza78a |
| 平台 | linux, macos, windows |
参考：完整 SKILL.md
:::info 以下是 Hermes 在触发此技能时加载的完整技能定义。这是技能激活时代理所看到的指令。 :::
Blender MCP
通过 TCP 端口 9876 上的套接字从 Hermes 控制正在运行的 Blender 实例。
设置（一次性）
1. 安装 Blender 插件
curl -sL https://raw.githubusercontent.com/ahujasid/blender-mcp/main/addon.py -o ~/Desktop/blender_mcp_addon.py
在 Blender 中： Edit > Preferences > Add-ons > Install > 选择 blender_mcp_addon.py 启用 “Interface: Blender MCP”
2. 在 Blender 中启动套接字服务器
在 Blender 视口中按 N 打开侧边栏。 找到 “BlenderMCP” 选项卡并点击 “Start Server”。
3. 验证连接
nc -z -w2 localhost 9876 && echo "OPEN" || echo "CLOSED"
协议
纯 UTF-8 JSON 通过 TCP 传输 —— 无长度前缀。
发送： {“type”: “<命令>”, “params”: {
可用命令
| type | params | 描述 |
|---|---|---|
| execute_code | code (str) | 运行任意的 bpy Python 代码 |
| get_scene_info | (无) | 列出场景中的所有物体 |
| get_object_info | object_name (str) | 特定物体的详细信息 |
| get_viewport_screenshot | (无) | 当前视口的屏幕截图 |
Python 辅助函数
在 execute_code 工具调用中使用：
import socket, json
def blender_exec(code: str, host="localhost", port=9876, timeout=15):
s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
s.connect((host, port))
s.settimeout(timeout)
payload = json.dumps({"type": "execute_code", "params": {"code": code}})
s.sendall(payload.encode("utf-8"))
buf = b""
while True:
try:
chunk = s.recv(4096)
if not chunk:
break
buf += chunk
try:
json.loads(buf.decode("utf-8"))
break
except json.JSONDecodeError:
continue
except socket.timeout:
break
s.close()
return json.loads(buf.decode("utf-8"))
常用 bpy 模式
清空场景
bpy.ops.object.select_all(action='SELECT')
bpy.ops.object.delete()
添加网格物体
bpy.ops.mesh.primitive_uv_sphere_add(radius=1, location=(0, 0, 0))
bpy.ops.mesh.primitive_cube_add(size=2, location=(3, 0, 0))
bpy.ops.mesh.primitive_cylinder_add(radius=0.5, depth=2, location=(-3, 0, 0))
创建并赋予材质
mat = bpy.data.materials.new(name="MyMat")
mat.use_nodes = True
bsdf = mat.node_tree.nodes.get("Principled BSDF")
bsdf.inputs["Base Color"].default_value = (R, G, B, 1.0)
bsdf.inputs["Roughness"].default_value = 0.3
bsdf.inputs["Metallic"].default_value = 0.0
obj.data.materials.append(mat)
关键帧动画
obj.location = (0, 0, 0)
obj.keyframe_insert(data_path="location", frame=1)
obj.location = (0, 0, 3)
obj.keyframe_insert(data_path="location", frame=60)
渲染到文件
bpy.context.scene.render.filepath = "/tmp/render.png"
bpy.context.scene.render.engine = 'CYCLES'
bpy.ops.render.render(write_still=True)
注意事项
- 运行前必须检查套接字是否已打开（nc -z localhost 9876）
- 每次会话都必须在 Blender 内部启动插件服务器（N 面板 > BlenderMCP > Connect）
- 将复杂场景拆分为多个较小的 execute_code 调用以避免超时
- 渲染输出路径必须使用绝对路径（/tmp/…），而非相对路径
- shade_smooth() 要求物体被选中且处于物体模式