AI导哈

Blender脚本控制工具

通过Claude控制Blender执行脚本、渲染场景和获取3D场景信息的本地服务工具。

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

使用说明

che搅拌机mcp

Blender MCP服务器 -通过Claude执行脚本、捕获渲染和控制3D场景。

特性

  • 6工具 用于全面控制搅拌机
  • 执行任意Python 完整代码 bpy 访问
  • 渲染场景 并将图像直接返回给Claude
  • 支持循环和EEVEE 渲染引擎
  • 无需GUI -在后台模式下运行Blender

快速开始

克劳德代码（CLI）

# Clone and install
git clone https://github.com/kiki830621/che-blender-mcp.git
cd che-blender-mcp
pip install -e .

# Add to Claude Code
claude mcp add che-blender-mcp -- python3 -m che_blender_mcp

适用于克劳德桌面

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "che-blender-mcp": {
      "command": "python3",
      "args": ["-m", "che_blender_mcp"],
      "env": {
        "BLENDER_PATH": "/Applications/Blender.app/Contents/MacOS/Blender"
      }
    }
  }
}

配置

搅拌机路径

默认情况下，服务器在以下位置查找Blender：

/Applications/Blender.app/Contents/MacOS/Blender

要使用其他路径，请设置 BLENDER_PATH 环境变量：

克劳德代码：

claude mcp add che-blender-mcp \
  --env BLENDER_PATH=/path/to/blender \
  -- python3 -m che_blender_mcp

克劳德桌面：

{
  "mcpServers": {
    "che-blender-mcp": {
      "command": "python3",
      "args": ["-m", "che_blender_mcp"],
      "env": {
        "BLENDER_PATH": "/path/to/blender"
      }
    }
  }
}

全部6个工具

工具 说明
execute_script 在Blender中执行任意Python代码 bpy 访问权限
list_objects 列出所有场景对象及其名称、类型、位置和可见性
get_object_info 获取详细信息：网格顶点/面、光能/颜色、相机镜头
render 渲染场景并返回base64编码的PNG图像
get_scene_info 获取相机、灯光、渲染设置、帧范围
screenshot 捕获视口屏幕截图（以50%的分辨率渲染以提高速度）

工具参数

execute_script

参数 类型 必填 说明
script string ✅ 要执行的Python代码
blend_file string 要首先打开的.blend文件的路径

list_objects

参数 类型 必填 说明
blend_file string 要打开的.blend文件的路径
object_type string 滤镜：网、相机、光、空、ARMATURE

get_object_info

参数 类型 必填 说明
object_name string ✅ 待检查对象的名称
blend_file string 要打开的.blend文件的路径

渲染

参数 类型 必填 说明
blend_file string ✅ 要渲染的.blend文件的路径
resolution_x integer 宽度（像素）（默认值：1920）
resolution_y integer 高度（像素）（默认值：1080）
samples integer 循环采样（默认值：128）
engine string 循环或BLENDER_EEVEE_NEXT（默认值：循环）

get_scene_info

参数 类型 必填 说明
blend_file string 要打开的.blend文件的路径

截图

参数 类型 必填 说明
blend_file string ✅ .blend文件的路径
view string 相机，顶部，前部，右侧（默认：相机）

使用示例

"Open my_scene.blend and list all objects"
"Render /path/to/scene.blend at 1080p with 256 samples"
"Execute this script in Blender: bpy.ops.mesh.primitive_cube_add()"
"Get info about the object named 'Camera'"
"Show me the scene information for my project"

示例：创建和渲染场景

"Execute this script:
import bpy
bpy.ops.mesh.primitive_monkey_add(location=(0, 0, 0))
bpy.ops.object.shade_smooth()
"

"Now render the scene at 720p"

需求

  • macOS 13.0（文图拉）或更高版本
  • 搅拌机 4.0+（推荐：Blender 5.0）
  • Python 3.10+

隐私

此扩展：

  • 在Mac上完全本地运行
  • 不对外传输任何数据
  • 仅访问本地Blender安装和指定的混合文件
  • 看 隐私.md 有关完整详细信息

版本历史记录

版本 更改
v0.1.0 初始版本包含6个工具：execute_script、list_objects、get_object_info、render、get_scene_info、屏幕截图

相关项目

许可证

麻省理工学院

作者

车成

相关 MCP