BlenderMCP: servicio MCP que se basa en Blender para generar modelos 3D

Introducción general

BlenderMCP 是一个开源工具，它通过 Modelo de Protocolo de Contexto (MCP) 协议将 Blender 与 Claude AI 连接起来。用户可以用文字指令直接控制 Blender，快速创建和编辑 3D 模型、场景和材质。这个工具适合 3D 设计师、开发者以及爱好者，能显著提高建模效率。它包含一个 Blender 插件和一个 MCP 服务端，支持双向通信、对象操作和场景查看等功能。BlenderMCP 目前在 GitHub 上免费提供，任何人都可以下载使用或参与开发。

Lista de funciones

• 双向通信：通过 socket 服务器实现 Claude AI 与 Blender 的实时互动。
• manipulación de objetos：能在 Blender 中创建、修改或删除 3D 对象。
• 材质调整：支持为对象添加或改变材质和颜色。
• 场景查看：获取当前 Blender 场景的详细信息。
• ejecución de código：通过 Claude 在 Blender 中运行 Python 代码。

Utilizar la ayuda

Proceso de instalación

BlenderMCP 需要安装两个部分：Blender 插件和 MCP 服务端。以下是具体步骤：

preliminar

• 软件要求：需要 Blender 3.0 或以上版本，以及 Python 3.10 或以上版本。
• Descargar plug-ins：访问 GitHub 页面，下载 addon.py Documentación.

安装 Blender 插件

1. 打开 Blender，点击菜单栏的 编辑 > 偏好设置 > 插件.
2. golpe (en el teclado) montaje 按钮，选择下载好的 addon.py Documentación.
3. 安装完成后，在插件列表中找到 Interface: Blender MCP，勾选启用。

启动 MCP 服务端

1. 打开终端，输入命令启动服务端：

uvx blender-mcp

2. 如果你在 Mac 上，先安装 uv 工具：

brew install uv

3. Windows 或其他系统用户，请查看 uv 官网 获取安装方法。

配置 Claude 桌面版（可选）

如果你使用 Claude 的桌面版，可以让它自动运行 BlenderMCP。具体操作如下：

1. 找到配置文件路径：

• macOS. ~/Library/Application Support/Claude/claude_desktop_config.json
• Ventanas. %APPDATA%/Claude/claude_desktop_config.json

2. 编辑文件，添加以下内容：

{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["blender-mcp"]
}
}
}

3. 保存后，Claude 会在需要时自动启动 MCP 服务端。

启动连接

1. 在 Blender 中，按 N 键打开 3D 视图侧边栏。
2. localice BlenderMCP 选项卡。
3. 设置端口号，默认是 9876（一般不用改）。
4. golpe (en el teclado) Start MCP Server 启动插件内的服务器。
5. 确认终端中 MCP 服务端也在运行（即执行了 uvx blender-mcp).

Cómo utilizar las principales funciones

连接成功后，你可以通过 Claude AI 输入文字指令操作 Blender。以下是具体用法：

查看场景信息

• directivas：输入 "Get information about the current scene"。
• efecto：Claude 调用 get_scene_info 工具，返回场景中的对象数量、位置等信息。
• procedimiento：在 Claude 界面输入指令，等待几秒后查看返回结果。

创建简单对象

• directivas：输入 "Create a sphere and place it above the cube"。
• efecto: a través de create_primitive，Blender 生成一个球体并放在立方体上方。
• procedimiento：输入指令后，Claude 会自动完成创建，你可以在 Blender 中看到结果。

调整对象材质

• directivas：输入 "Make this car red and metallic"。
• efecto: Uso set_material responder cantando modify_object，将车的材质改为红色金属质感。
• procedimiento：确保场景中有车对象，输入指令后检查材质变化。

删除对象

• directivas：输入 "Delete the cube"。
• efecto: Llamada delete_object，移除场景中的立方体。
• procedimiento：输入指令后，回到 Blender 确认立方体已消失。

运行 Python 代码

• directivas：输入 "Run this code in Blender: bpy.ops.mesh.primitive_uv_sphere_add(radius=2, location=(0,0,5))"。
• efecto: a través de execute_blender_code，在 Blender 中创建一个半径为 2、位置在 (0,0,5) 的球体。
• procedimiento：输入完整指令，Claude 会将代码发送到 Blender 执行。注意：运行前先保存文件，以防出错。

创建复杂场景

• directivas：输入 "Create a low poly scene in a dungeon, with a dragon guarding a pot of gold"。
• efecto：Claude 会逐步调用多个工具，生成低多边形地牢、龙和金罐场景。
• procedimiento：输入指令后等待片刻，Blender 会显示完整场景。参考 。

flujo de trabajo

1. Inicio de los servicios：按“启动连接”步骤，确保 Blender 插件和 MCP 服务端都运行。
2. entrada：在 Claude 界面输入你想执行的操作，比如创建对象或调整灯光。
3. 确认结果：回到 Blender，查看场景是否按指令更新。
4. 解决问题：如果没反应，打开 Blender 的控制台（窗口 > 切换控制台），查看错误信息。

advertencia

• 简化任务：复杂指令可能需要拆成小步骤，比如先创建对象，再修改属性。
• 安全提示: Uso execute_blender_code 时要小心，避免运行未知代码导致程序崩溃。
• fallo de conexión：如果无法连接，检查端口号是否一致，防火墙是否阻拦。

通过这些操作，你可以用简单的文字指令在 Blender 中快速构建 3D 模型和场景，省时又方便！

Descripción en una frase (breve)

BlenderMCP 是一个开源工具，通过 Model Context Protocol 连接 Blender 和 Claude AI，用户可以用文字指令在 Blender 中创建和修改 3D 模型、场景及材质，支持对象操作、材质调整和 Python 代码执行，适合快速生成高质量 3D 内容。