金大哥 - mcp_link_blender MCP 详情

article

README

🚀 MCP-Link for Blender

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

MCP-Link 截图

🚀 快速开始

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 扩展程序安装

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

方法 2：从 ZIP 文件安装

从发布页面下载 mcp_link_blender-x.x.x.zip。
打开 Blender。
转到 编辑 → 首选项 → 插件。
点击 从磁盘安装...。
选择 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 命令

| 命令 | 描述 | |------|------| | make | 构建扩展程序 ZIP 文件 | | make install | 构建并安装到 Blender | | make clean | 删除构建产物 | | make version | 显示当前版本 | | make bump-patch | 增加补丁版本号（1.0.0 → 1.0.1） | | make bump-minor | 增加次版本号（1.0.0 → 1.1.0） | | make bump-major | 增加主版本号（1.0.0 → 2.0.0） |

工作原理

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

隐私与安全

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

故障排除

扩展程序无法连接

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

命令无法执行

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

🤝 贡献

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

📄 许可证

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

👏 致谢

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

链接:

mcp_link_blender