搞定BlenderMCP参数配置：从安装到uvx命令行全攻略

【免费下载链接】blender-mcp 项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp

还在为Blender与AI工具的连接配置头疼？本文将手把手教你完成BlenderMCP的环境搭建、参数配置和命令行使用，让你轻松实现AI辅助3D建模。读完本文你将掌握：

• 快速配置BlenderMCP开发环境
• 理解并设置关键环境变量
• 正确使用uvx blender-mcp命令行工具
• 解决常见连接问题的实用技巧

什么是BlenderMCP？

BlenderMCP通过模型上下文协议（Model Context Protocol, MCP）将Blender与Claude AI连接，实现AI直接交互和控制Blender。这种集成支持提示辅助的3D建模、场景创建和操作。

BlenderMCP系统由两个主要组件构成：

• Blender插件 (addon.py)：在Blender内创建基于套接字的服务器，接收并执行命令
• MCP服务器 (src/blender_mcp/server.py)：实现模型上下文协议并连接到Blender插件

安装准备工作

环境要求

• Blender 3.0或更高版本
• Python 3.10或更高版本
• uv包管理器

安装uv包管理器

根据你的操作系统选择正确的安装命令：

Mac用户：

brew install uv

Windows用户：

powershell -c "irm https://astral.sh/uv/install.ps1 | iex" 
set Path=C:\Users\nntra\.local\bin;%Path%

其他系统请参考uv安装文档

参数配置详解

环境变量设置

BlenderMCP提供了环境变量来自定义连接配置：

环境变量	默认值	描述
BLENDER_HOST	"localhost"	Blender套接字服务器的主机地址
BLENDER_PORT	9876	Blender套接字服务器的端口号

设置示例：

export BLENDER_HOST='host.docker.internal'
export BLENDER_PORT=9876

核心配置文件

Claude桌面版配置

编辑Claude配置文件claude_desktop_config.json，添加以下内容：

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

Cursor编辑器配置

Windows用户配置示例：

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

Blender插件安装与设置

安装Blender插件

1. 从仓库下载addon.py文件
2. 打开Blender
3. 进入编辑 > 偏好设置 > 插件
4. 点击"安装..."并选择下载的addon.py文件
5. 启用"Interface: Blender MCP"插件

连接到Claude

1. 在Blender中，打开3D视图侧边栏（如未显示按N键）
2. 找到"BlenderMCP"选项卡
3. 如果需要使用Poly Haven资产，勾选对应的复选框
4. 点击"Connect to Claude"
5. 确保MCP服务器已在终端中运行

连接成功后，你将在Claude界面看到BlenderMCP的锤子图标：

uvx blender-mcp命令行工具详解

基本使用方法

BlenderMCP使用uv包管理器的uvx命令运行，基本语法：

uvx blender-mcp

该命令会启动MCP服务器，默认连接到本地Blender实例。

常用参数说明

虽然uvx blender-mcp命令本身没有直接参数，但可以通过环境变量进行配置：

# 设置Blender主机地址
export BLENDER_HOST='localhost'
# 设置Blender端口
export BLENDER_PORT=9876
# 启动MCP服务器
uvx blender-mcp

集成到不同编辑器

VS Code集成

点击下方按钮将BlenderMCP服务器安装到VS Code：

THE 2TH POSITION OF THE ORIGINAL IMAGE

常见问题解决

连接超时问题

1. 确保Blender插件已启动并显示"Connected"状态
2. 检查防火墙设置，确保端口9876未被阻止
3. 尝试简化请求或分解为更小的步骤

多客户端冲突

⚠️ 注意：不要同时在Cursor和Claude Desktop中运行MCP服务器，这会导致端口冲突。

通信错误

如果遇到通信错误，尝试以下步骤：

1. 重启Blender插件
2. 重启MCP服务器
3. 在Claude中删除MCP服务器并重新添加

功能展示与示例

基本场景操作

成功连接后，可以直接在Claude中发送指令，例如：

• "创建一个低多边形场景，地牢中有一条龙守护着一罐金子"
• "使用Poly Haven的HDRI、纹理和模型（如岩石和植被）创建海滩氛围"
• "生成花园 gnome 的3D模型（通过Hyper3D）"

高级材质控制

BlenderMCP支持通过AI指令控制材质和纹理：

# 示例Python代码（可在Claude中直接发送）
import bpy

# 创建新材质
mat = bpy.data.materials.new(name="GoldMaterial")
mat.use_nodes = True

# 清除默认节点
nodes = mat.node_tree.nodes
for node in nodes:
    nodes.remove(node)

# 创建节点
output = nodes.new(type='ShaderNodeOutputMaterial')
principled = nodes.new(type='ShaderNodeBsdfPrincipled')
links = mat.node_tree.links
links.new(principled.outputs[0], output.inputs[0])

# 设置金色材质属性
principled.inputs['Base Color'].default_value = (0.9, 0.7, 0.1, 1)
principled.inputs['Metallic'].default_value = 1.0
principled.inputs['Roughness'].default_value = 0.2

# 应用到选中对象
if bpy.context.active_object.data.materials:
    bpy.context.active_object.data.materials[0] = mat
else:
    bpy.context.active_object.data.materials.append(mat)

总结与下一步

通过本文的指南，你已经掌握了BlenderMCP的参数配置和命令行使用方法。现在你可以开始探索AI辅助3D建模的无限可能：

1. 尝试不同的场景生成提示词
2. 探索Poly Haven的高质量材质库
3. 利用Hyper3D生成独特的3D模型
4. 开发自定义Python脚本扩展功能

官方文档：README.md

如有任何问题，欢迎提交issue或参与社区讨论。祝你在AI辅助3D创作的旅程中取得成功！

【免费下载链接】blender-mcp 项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp