MCP Link Blender

🚀 MCP-Link for Blender

MCP-Link for Blender 能将 Blender 转变为一个可由人工智能控制的 3D 创作平台。它通过模型上下文协议（MCP）将 Blender 的整个 Python API 向 AI 代理开放，无需硬编码命令，提供纯粹、通用的 API 访问，让 AI 能够执行 Blender 所能完成的任何操作。

🚀 快速开始

MCP-Link for Blender 借助模型上下文协议（MCP），把 Blender 的整个 Python API 开放给 AI 代理，让 AI 可以通过自然语言控制 Blender 进行 3D 创作。

✨ 主要特性

• 开创性的基础设施：与传统插件不同，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-Link 服务器。
  • ✅ 自动重连：能优雅地处理连接中断问题。
  • ✅ 线程安全：通过 bpy.app.timers 在主线程执行 Blender API 调用，确保线程安全。

📦 安装指南

要求

• Blender 4.2+ - 从 blender.org 下载
• MCP-Link 服务器 - 从 AuraFriday 免费下载
• 支持 MCP 的 AI - Cursor、Claude Code 或任何 MCP 客户端

安装方法

方法 1：从 Blender 扩展程序安装

1. 打开 Blender。
2. 转到 编辑 → 首选项 → 获取扩展程序。
3. 搜索 "MCP-Link"。
4. 点击 安装。

方法 2：从 ZIP 文件安装

1. 从 发布页面 下载 mcp_link_blender-x.x.x.zip。
2. 打开 Blender。
3. 转到 编辑 → 首选项 → 插件。
4. 点击 从磁盘安装...。
5. 选择 ZIP 文件。

方法 3：命令行安装

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

💻 使用示例

基础用法

创建一个 3D 立方体

{
  "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!')"
}

📚 详细文档

从源代码构建

# 克隆仓库
git clone https://github.com/AuraFriday/mcp_link_blender.git
cd MCP-Link-Blender

# 构建扩展程序
make build

# 安装到 Blender
make install

Makefile 命令

工作原理

1. 扩展程序加载：Blender 启动时加载扩展程序。
2. 自动连接：通过 SSE 自动连接到本地 MCP-Link 服务器。
3. 注册远程工具：将 "blender" 注册为远程工具。
4. 监听命令：监听来自 AI 代理的命令。
5. 主线程执行：通过 bpy.app.timers 在主线程执行命令，确保线程安全。
6. 返回结果：将执行结果返回给 AI 代理。

隐私与安全

• ✅ 完全本地运行：所有处理都在本地机器上进行。
• ✅ 无云依赖：完全离线工作。
• ✅ 无数据收集：您的设计数据不会离开您的计算机。
• ✅ 开源：代码完全透明，可审计。
• ✅ GPL - 3.0 许可证：自由使用。

故障排除

扩展程序无法连接

1. 确保 MCP-Link 服务器正在运行。
2. 检查 Blender 的系统控制台以查看错误消息。
3. 验证服务器是否在预期端口上监听。

命令无法执行

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

🤝 贡献

欢迎贡献代码！请参阅 CONTRIBUTING.md 获取贡献指南。

📄 许可证

采用 GPL - 3.0 或更高版本许可证，详情请参阅 LICENSE。

👏 致谢

由 Aura Friday 创建，此前的插件已获得 15000 多名用户的信赖。

链接:

• MCP-Link 服务器下载
• GitHub 仓库
• 问题跟踪器