MCP link blender

搅拌机的MCP链接

将Blender转化为AI可控的3D创作平台

Blender的MCP-Link通过模型上下文协议（MCP）将Blender的整个Python API公开给AI代理。没有硬编码的命令-只有纯粹的、通用的API访问，让AI做任何Blender能做的事情。

MCP-Link Screenshot

是什么让这场革命

与传统的附加组件不同，MCP-Link提供 基础设施这是一个桥梁，让任何AI代理——ChatGPT、Claude、Cursor或自定义代理——通过自然语言控制Blender。

权力的三个层次

1. Python执行 -在Blender的运行时运行任意Python代码 bpy 访问
2. 直接API调用 -执行任何Blender操作符或访问任何数据
3. MCP工具集成 -访问10多种工具（SQLite、浏览器、AI模型等）

特性

• ✅ 100%通用API -适用于任何Blender命令
• ✅ 完全Python访问权限 -完整运行任意Python代码 bpy 访问
• ✅ 持续会话 -变量在多个AI命令中持续存在
• ✅ MCP工具生态系统 -SQLite、浏览器自动化、系统控制等
• ✅ 自动连接 -启动时扩展连接到MCP链路服务器
• ✅ 自动重新连接 -优雅地处理连接中断
• ✅ 线程安全 -为Blender API调用执行正确的主运行

需求

• 搅拌机4.2+ - 从blender.org下载
• MCP链路服务器 - 从Aura1Friday免费下载
• MCP兼容AI - 光标Claude Code或任何MCP客户端

安装

方法1：来自Blender扩展

1. 打开搅拌机
2. 首选 Edit → 偏好设置→ 获取扩展
3. 搜索“MCP链接”
4. 点击 安装

方法2：从ZIP文件

1. 下载 mcp_link_blender-x.x.x.zip 从 发布
2. 打开搅拌机
3. 首选 Edit → 偏好设置→ 附加组件
4. 点击 从磁盘安装。..
5. 选择ZIP文件

方法3：命令行

blender --command extension install-file -r user_default -e mcp_link_blender-1.0.0.zip

使用示例

创建三维立方体

{
  "operation": "execute_python",
  "code": "import bpy\nbpy.ops.mesh.primitive_cube_add(size=2, location=(0, 0, 1))\nprint(f'Created: {bpy.context.active_object.name}')"
}

创建完整场景

{
  "operation": "execute_python",
  "code": "import bpy\n\n# Clear scene\nbpy.ops.object.select_all(action='SELECT')\nbpy.ops.object.delete()\n\n# Add ground plane\nbpy.ops.mesh.primitive_plane_add(size=10)\n\n# Add a sphere\nbpy.ops.mesh.primitive_uv_sphere_add(radius=1, location=(0, 0, 1))\nsphere = bpy.context.active_object\n\n# Add material\nmat = bpy.data.materials.new('Red')\nmat.diffuse_color = (1, 0, 0, 1)\nsphere.data.materials.append(mat)\n\nprint('Scene created!')"
}

渲染到文件

{
  "operation": "execute_python",
  "code": "import bpy\nbpy.context.scene.render.filepath = '/tmp/render.png'\nbpy.ops.render.render(write_still=True)\nprint('Rendered!')"
}

从源头构建

# Clone the repository
git clone https://github.com/AuraFriday/mcp_link_blender.git
cd MCP-Link-Blender

# Build the extension
make build

# Install to Blender
make install

Makefile命令

运作原理

1. 延伸载荷 搅拌机启动时
2. 自动连接 通过SSE连接到本地MCP链路服务器
3. 注册“搅拌机” 作为远程工具
4. 监听命令 来自AI代理
5. 在主线程上执行 通过 bpy.app.timers 螺纹安全
6. 返回结果 到AI代理

隐私和安全

• ✅ 100%本地 -所有处理都在您的机器上进行
• ✅ 无云依赖 -完全离线工作
• ✅ 无数据收集 -你的设计永远不会离开你的电脑
• ✅ 开源 -完全透明、可审计的代码
• ✅ GPL-3.0许可证 -自由如自由

故障排除

扩展未连接

1. 确保MCP链路服务器正在运行
2. 检查Blender的系统控制台是否有错误消息
3. 验证服务器是否正在侦听预期端口

命令未执行

1. 确保Blender在大多数操作中处于对象模式
2. 在操作所需对象之前，请检查它们是否存在
3. 查看响应中的错误消息

贡献

欢迎投稿！请查看 贡献.md 作为指导方针。

许可证

GPL-3.0或更高版本-请参阅 许可证 了解详情。

学分

由...创建 光环星期五 -受到15000多名以前加载项用户的信任。

______________________________________________________________________

链接：

• MCP链路服务器下载
• 问题追踪器