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、屏幕截图 |
______________________________________________________________________
相关项目
- chethings mcp -用于Things 3任务管理的MCP服务器
- che-ical-mcp -用于macOS日历和提醒的MCP服务器
______________________________________________________________________
许可证
麻省理工学院
