BlendBridge
MCP server that lets Claude control Blender 5.0 for creating low-poly 3D models. Designed for game dev workflows targeting Godot and Bevy.
运作原理
克劳德写完整 bpy Python脚本在Blender中执行，获取视口截图以查看结果，迭代并导出到GLB。
Claude ──MCP──► mcp_server.py ──HTTP──► Blender Addon ──bpy──► Blender
◄── screenshot安装
1.安装Python依赖项
cd /path/to/blendbridge
uv sync2.安装搅拌机插件
- 打开搅拌机5.0
- 首选 编辑>首选项>附加组件
- 点击 从磁盘安装。..
- 导航至
addon/blendbridge_addon/然后选择文件夹（或先压缩） - 启用 BlendBridge 在插件列表中
或者，将插件符号链接到Blender的插件目录中：
ln -s /path/to/blendbridge/addon/blendbridge_addon ~/.config/blender/5.0/scripts/addons/blendbridge_addon然后在Blender的插件首选项中启用它。
3.配置插件（可选）
在Blender的BlendBridge插件偏好设置中：
- 端口：HTTP服务器端口（默认值：8400）
- 自动启动：启用插件时启动服务器（默认值：是）
4.在Claude Code中注册MCP服务器
claude mcp add blendbridge -- uv run --directory /path/to/blendbridge python mcp_server.py就是这样。MCP服务器在本地主机上通过HTTP与Blender插件通信。
配置
编辑 config.yaml 自定义：
# All optional — defaults shown
port: 8400 # Must match Blender addon port
export_base: ./exports/ # Where exported models are saved
screenshot_dir: /tmp/blendbridge/ # Temporary screenshots
system_prompt: null # Path to custom .md prompt (null = built-in)自定义系统提示
内置提示(prompts/default.md)包括bpy模式、低多边形约定和Godot/Bevy导出提示。要覆盖，请执行以下操作：
system_prompt: ~/my-game/blender-style-guide.md快速测试
- 在启用插件的情况下打开Blender 5.0
- 启动Claude Code会话
- 问克劳德：
在Blender中创建一棵低多边形树并截图
Claude应该编写一个bpy脚本来创建树，执行它，并向您显示视口屏幕截图。
工具
| 工具 | 说明 |
|---|---|
execute_script | 在Blender中运行bpy Python脚本 |
screenshot | 使用可配置的着色模式捕获3D视口 |
set_viewport | 定位视口摄影机（预设或自定义角度） |
render | 全渲染（较慢，以获得最终质量） |
get_scene_info | 列出带有颜色和边界的对象、灯光、材质 |
export_model | 导出到GODO/Bevy的GLB/glTF |
clear_scene | 删除所有内容，重新开始 |
项目结构
blendbridge/
├── README.md
├── pyproject.toml # Project config + dependencies
├── config.yaml # MCP server config
├── mcp_server.py # MCP server (stdio transport)
├── blender_client.py # HTTP client → Blender addon
├── prompts/
│ └── default.md # Built-in system prompt
└── addon/
└── blendbridge_addon/ # Blender addon
├── __init__.py # Addon registration
├── server.py # HTTP server (background thread)
├── executor.py # Main thread script executor
└── handlers.py # Request handlers发展
更新Blender插件
更改中的任何文件后 addon/blendbridge_addon/:
- 重新构建zip：
cd addon && zip -r ../blendbridge_addon.zip blendbridge_addon/ -x "blendbridge_addon/__pycache__/*"- 在Blender中： 编辑>首选项>获取扩展 --卸载旧版本
- 从磁盘安装 使用新的zip
- 重新启动Blender（某些更改需要完全重新启动）
更新MCP服务器
更改为 mcp_server.py, blender_client.py，或 config.yaml 在下一个Claude Code会话中生效（MCP服务器自动重新启动）。
测试插件HTTP服务器
# Health check
curl http://127.0.0.1:8400/health
# Run a script
curl -X POST http://127.0.0.1:8400/execute \
-H "Content-Type: application/json" \
-d '{"script": "import bpy; print(list(bpy.data.objects))"}'
# Scene info
curl http://127.0.0.1:8400/scene_info需求
- 搅拌机5.0
- Python 3.10+
- 紫外线
- 克劳德代码