{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}

Blender Mcp

通过 socket 连接 blender-mcp 插件，直接从 Hermes 控制 Blender。可创建 3D 对象、材质、动画，并运行任意 Blender Python（bpy）代码。当用户需要在 Blender 中创建或修改任何内容时使用。

Skill 元数据


来源	可选 — 通过 `hermes skills install official/creative/blender-mcp` 安装
路径	`optional-skills/creative/blender-mcp`
版本	`1.0.0`
作者	alireza78a
平台	linux, macos, windows

参考：完整 SKILL.md

信息

以下是 Hermes 在触发此 skill 时加载的完整 skill 定义。这是 agent 在 skill 激活时所看到的指令内容。

Blender MCP

通过 TCP 端口 9876 上的 socket，从 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 中启动 socket 服务器

在 Blender 视口中按 N 键打开侧边栏。
找到 "BlenderMCP" 标签页，点击 "Start Server"。

3. 验证连接

nc -z -w2 localhost 9876 && echo "OPEN" || echo "CLOSED"

协议

通过 TCP 传输纯 UTF-8 JSON — 无长度前缀。

发送： {"type": "<command>", "params": {<kwargs>}}
接收： {"status": "success", "result": <value>}
{"status": "error", "message": "<reason>"}

可用命令

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)

注意事项

运行前必须检查 socket 是否已开放（nc -z localhost 9876）

每次会话都需要在 Blender 内部启动插件服务器（N 面板 > BlenderMCP > Connect）

将复杂场景拆分为多个较小的 execute_code 调用，以避免超时

渲染输出路径必须为绝对路径（/tmp/...），不能使用相对路径

shade_smooth() 要求对象已被选中且处于对象模式

"Blender Mcp — 通过 socket 连接 blender-mcp 插件，直接从 Hermes 控制 Blender"

Blender Mcp#

Skill 元数据#

参考：完整 SKILL.md#

Blender MCP#

设置（一次性）#

1. 安装 Blender 插件#

2. 在 Blender 中启动 socket 服务器#

3. 验证连接#

协议#

可用命令#

Python 辅助函数#

常用 bpy 模式#

清空场景#

添加网格对象#

创建并指定材质#

关键帧动画#

渲染到文件#

注意事项#

Blender Mcp

Skill 元数据

参考：完整 SKILL.md

Blender MCP

设置（一次性）

1. 安装 Blender 插件

2. 在 Blender 中启动 socket 服务器

3. 验证连接

协议

可用命令

Python 辅助函数

常用 bpy 模式

清空场景

添加网格对象

创建并指定材质

关键帧动画

渲染到文件

注意事项