当前位置：首页 > news >正文

一、前置环境校验

news 2026/6/25 14:40:39

在开始部署前，先确认你的环境满足最低要求，避免后续出现兼容性问题：

Blender：3.0及以上版本（推荐4.0+，稳定性更佳）
Cursor：最新正式版（已内置MCP协议支持，无需额外安装插件）（用别的 trae、claude code、codex也是一样的，仅配置mcp步骤略有区别）
Python：3.10及以上版本（Windows/Mac系统一般预装，可在终端输入python --version校验）
网络环境：能正常访问GitHub，无特殊网络限制（若有网络问题，可提前配置好终端代理）

二、核心第一步：安装并配置uv包管理器

这是整个部署流程最关键、最优先执行的步骤。blender-mcp的运行完全依赖uvx命令，而uvx是uv包管理器内置的工具，必须先完成uv的安装和环境配置。

2.1 安装uv

根据你的操作系统，在对应终端执行安装命令：

Windows系统：
1. 以管理员身份打开PowerShell（右键开始菜单→Windows PowerShell(管理员)）
2. 复制以下命令，回车执行：
```
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
```
3. 等待执行完成，终端出现安装成功提示，即完成uv的安装。
Mac系统：
1. 打开终端，直接执行brew安装命令：
```
brew install uv
```
2. 等待brew执行完成，无报错即安装成功。

安装之后可以用以下命令检测是否成功正确安装

2.2 配置环境变量（Windows必做，Mac可选）

Windows系统安装完成后，需要手动将uv的安装目录添加到系统环境变量，否则终端会提示「uvx不是内部或外部命令」：

打开PowerShell，依次执行以下2行命令，永久添加环境变量：

$localBin = "$env:USERPROFILE\.local\bin" $userPath = [Environment]::GetEnvironmentVariable("Path", "User") [Environment]::SetEnvironmentVariable("Path", "$userPath;$localBin", "User")

执行完成后，重启PowerShell/终端，让环境变量生效。

2.3 验证安装是否成功

重启终端后，执行以下命令，校验uv和uvx是否正常工作：

uv --version uvx --version

若终端输出版本号，无报错，即说明核心依赖安装完成；若仍提示命令不存在，重启电脑后再次校验即可。

三、第二步：Blender端安装与配置blender-mcp插件

3.1 下载插件核心文件

blender-mcp的插件核心是addon.py文件，有2种获取方式，任选其一即可：

方式一：git克隆（推荐，方便后续更新）
打开终端，进入你想存放项目的目录，执行git克隆命令：
```
git clone https://github.com/ahujasid/blender-mcp.git
```
克隆完成后，打开文件夹，即可在根目录找到addon.py文件。
方式二：直接下载单个文件
1. 打开blender-mcp的GitHub仓库：GitHub - ahujasid/blender-mcp: Open-source MCP to use Blender with any LLM · GitHub
  
  按照以上步骤下载压缩包之后并解压，确保解压之后文件夹如下所示

注意：若你之前安装过旧版blender-mcp，需先在Blender中禁用并卸载旧版插件，再安装新版，避免冲突。

3.2 Blender内安装插件

打开你的Blender软件，点击顶部菜单栏的「编辑(Edit)」→「偏好设置(Preferences)」。
在弹出的偏好设置窗口中，左侧切换到「插件(Add-ons)」选项卡。
点击窗口右上角的「安装(Install...)」按钮，在文件浏览器中，选择你刚才下载的addon.py文件，点击「安装插件(Install Add-on)」。
安装完成后，在插件列表中，搜索「Blender MCP」，会找到名为「Interface: Blender MCP」的插件，勾选插件前方的复选框，启用插件。

3.3 验证插件加载成功

启用插件后，关闭偏好设置窗口，回到Blender的3D视图界面：

按下键盘上的N键，调出3D视图的右侧侧边栏。
在侧边栏的标签中，找到「BlenderMCP」标签，点击进入，若能看到插件的控制面板（包含端口设置、连接按钮、资产开关等），即说明插件安装成功。

### 3.4 插件基础配置

插件面板中可提前完成全部基础配置，一次设置长期生效，后续使用无需重复调整，各项配置详细说明如下：

端口(Port)：为Blender插件与MCP后端服务通信的本地TCP端口，相当于两者互联的专属通道。默认固定为9876，常规使用无需修改；仅在端口被其他软件占用时更换端口，必须保证插件端口与MCP服务端口完全一致，端口不匹配会导致连接失败、AI功能全部失效。
Poly Haven资产：Poly Haven为免费开源3D资源平台，包含模型、材质、HDRI环境贴图等素材。勾选对应复选框后，AI可自动联网下载并调用该平台资源，快速搭建完整场景；无需外部资源自动加载时可不开启，属于可选配置，关闭不影响插件核心功能。
Sketchfab资产：全球大型3D模型共享平台，拥有海量免费及付费三维资源。开启该选项可允许插件调用平台模型，需填写专属API Key完成权限认证，否则会出现访问限制、调用失败问题，适合需要快速调取特色模型的使用场景。
Hyper3D Rodin AI生成服务：云端3D生成工具，支持通过文字描述快速生成三维模型。开启后可接入官方云端API，搭配专属API密钥解锁使用额度，同时支持一键申领免费试用密钥，快速启用AI建模能力。
腾讯混元3D生成服务：独立的AI三维生成方案，可与Hyper3D服务并行启用。支持本地API部署与云端接入两种模式，填写对应服务地址即可使用；本地部署版本无需联网、响应更快，无云端额度限制，兼顾隐私与批量创作需求。
八叉树分辨率(Octree Resolution)：控制AI生成模型的体素精度，决定模型细节丰富度与整体面数。数值越高模型细节越精致，硬件消耗与生成时长越高；数值越低生成速度越快、模型轻量化，适合快速预览，默认256为均衡参数。
推理步数(Number of Inference Steps)：AI建模的迭代打磨次数。步数越高，模型造型越规整、瑕疵越少；步数越低生成效率越快，容易出现模型破损、造型扭曲等问题，可根据画质需求灵活调整。
引导系数(Guidance Scale)：用于平衡AI生成内容与文字描述的贴合度。数值偏高时，生成效果严格遵循提示词要求；数值偏低时AI创作自由度更高，风格更随机，合理参数可避免模型生硬或偏离需求。
生成纹理(Generate Texture)：控制AI是否同步输出模型材质与纹理贴图。关闭后仅生成纯白模型，运行速度快、性能压力小；开启后自动搭配色彩、法线等材质贴图，一键产出成品模型，耗时与硬件占用会相应增加。
断开MCP服务器连接：手动切断插件与MCP后端的通信连接，一键停用所有AI生成、资源调用功能。多用于重启服务、临时关闭AI功能的场景。
端口运行状态提示：实时显示插件当前监听运行的端口，用于快速核对端口配置是否正常，直观确认插件通信服务是否成功启动。
遥测设置：用于收集插件匿名使用数据，辅助开发者优化迭代。若注重隐私、拒绝数据上传，可在插件偏好设置内取消遥测同意勾选，关闭后不影响插件所有核心使用功能，为可选配置。

四、第三步：Agent 端MCP服务配置

这一步是建立和Blender通信的核心，我们提供全局MCP配置（推荐）和项目专属配置两种方案，任选其一即可。这边我们以Cursor为例

重要提醒：不要同时在多个客户端（Claude、Cursor等）运行同一个blender-mcp服务，否则会出现端口占用、连接失败的问题。

4.1 方案一：全局MCP服务器配置（推荐）

全局配置完成后，你在Cursor中打开的所有项目，都可以直接使用Blender MCP服务，无需重复配置。

打开Cursor编辑器，点击左下角的设置图标，打开设置面板。
在设置面板的左侧菜单中，找到「MCP」选项，点击进入MCP配置页面。
点击页面中的「Add new global MCP server（添加新的全局MCP服务器）」按钮，会弹出一个JSON配置编辑框。
根据你的操作系统，复制对应的配置代码，粘贴到编辑框中，点击保存：
- 系统配置：
```
{ "mcpServers": { "blender": { "command": "uvx", "args": ["blender-mcp"] ] } } }
```