1. 在 Blender 4.2 里装好 blender-mcp:插件装完却搜索不到
1.1 前置环境:win10 + Python 3.13.2 + Blender 4.2.2
在 Blender 4.2 里装完 blender-mcp 却搜不到插件,很多人以为插件没装上,其实是右上角工具栏没拉出来;TRAE 跑 Blender MCP 做 AI 建模时,还有一关比 MCP 本身更容易被忽略——TRAE 底层调用的模型 Key。我先从 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content= 创建了 TaoToken Key,再回头配置 Blender MCP,整条链路一次跑通。
先说环境参数,Windows 10、Python 3.13.2、Blender 4.2.2,这三个版本组合跑 blender-mcp 是稳的。Blender 4.2 的插件设置界面改动不小,Add-ons 面板默认被压得很窄,第一次装 blender-mcp 时,启用后去 Preferences 里搜索“blender-mcp”,结果列表里什么都没有。实际上插件已经装进去了,只是右侧栏被收成了一条缝,插件列表和启用勾选框根本没有显示出来。
把 GitHub 仓库下载到本地后,在 Blender 的 Edit → Preferences → Add-ons 里点 Install,选择下载好的压缩包。安装成功后,启用项会出现在 Community 分类下,名称类似“Blender MCP”。如果不勾选启用,后面 uvx blender-mcp 虽然能启动,Blender 端也不会真正响应任何操作。
1.2 把右上角工具栏拉出来,插件就出现了
这个细节非常容易漏。Preferences 窗口的右上角有一条几乎不可见的窄边,鼠标移上去会变成左右拖动的光标。按住那条边往左拖,原本被折叠的插件列表区域才会展开,下面能看到搜索框、分类筛选和每个插件的启用勾选框。拖出来后搜索“mcp”,把 Blender MCP 那一项勾上,Blender 这一侧才算真正准备好。
这里有一个容易混淆的地方:TRAE 的 MCP Server 配置里写的是 uvx blender-mcp,它启动的是本地进程,与 Blender 插件是两回事。插件负责在 Blender 内部接收指令,uvx blender-mcp 负责把 MCP 协议翻译成 Blender 能懂的 Python API 调用。两步都齐全,后面测试才会一次通过。
2. 给 TRAE 准备一把 TaoToken Key,并填好模型接口
2.1 MCP 不消耗 Token,TRAE 消耗:所以 Key 要单独准备
很多人以为把 blender-mcp 接进 TRAE,AI 建模就能自动跑起来。实际上 MCP 只负责把 TRAE 发来的“新建立方体并旋转”这类指令翻译成 Blender 能执行的动作,它不调用任何大模型,也不消耗 Token。真正消耗的是 TRAE 与模型之间的对话:TRAE 要把自然语言指令发给某个模型,拿到模型返回的工具调用参数,再交给 MCP 去执行。
不少人在这一步被卡住,是因为 TRAE 自带的模型额度用一阵就提示受限,或者模型 ID 版本和文档对不上。与其在多个 Key 之间来回切换,不如统一走一个兼容入口。TaoToken 提供的是 OpenAI 兼容的统一 API 通道,注册后在控制台创建一把 Key,把它填到 TRAE 自定义模型配置里,模型请求就会集中走同一入口。注册和创建 Key 都在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content= 完成。
2.2 TRAE 的 OpenAI 兼容配置:Base URL 与模型 ID
打开 TRAE 的设置,找到自定义模型或 OpenAI 兼容接口这一项,新增一个供应商。关键配置就三个值:
| 配置项 | 值 |
|---|---|
| Base URL | https://taotoken.net/api |
| API Key | YOUR_API_KEY |
| 模型 ID | 以 TaoToken 模型广场当时列表为准 |
Base URL 末尾不要加 /v1。TRAE 会按 OpenAI 格式自动拼接请求路径,你手动补了 /v1,反而会多出一层目录导致连接失败。API Key 把 YOUR_API_KEY 替换成在 TaoToken 创建的那串值。模型 ID 不要凭记忆写,也不要按网上旧教程填带日期后缀的版本号,直接到模型广场复制当时列表里的准确 ID。这样配置完,TRAE 后续所有模型请求都会走 https://taotoken.net/api,和官网控制台是两条路径:控制台看用量,Base URL 只面向工具。
3. 安装 uvx 并把 blender-mcp 注册成 TRAE 的 MCP Server
3.1 用 PowerShell 安装 uv / uvx
blender-mcp 通过 uvx 启动。uvx 是 uv 自带的一个命令行工具,作用是根据命令名临时拉取并运行 Python 包。Windows 下安装最直接的方式是在 PowerShell 里执行:
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"安装完成后,uv 安装器会提示你把用户目录下的 .local\bin 加进 PATH。很多人跳过这一步,结果 TRAE 里 MCP Server 一直显示红色。处理方法是:重新打开一个 PowerShell,运行 uv --version 和 uvx --version 确认能识别;如果提示找不到命令,手动把 C:\Users\你的用户名.local\bin 加入系统环境变量,然后关闭并重开 PowerShell。
这一步有一个隐含要求:环境变量修改后,TRAE 也要完全重启。TRAE 如果是在安装 uv 之前打开的,它读到的 PATH 里没有 uvx,MCP Server 就会一直连接失败。先关掉 TRAE 再重新打开,再添加 MCP,比在旧进程里反复重试要省时间。
3.2 在 TRAE 里添加 MCP Servers 并看绿色对勾
打开 TRAE 的 MCP Servers 配置面板,选择添加,把下面这段 JSON 粘贴进去:
{ "mcpServers": { "blender": { "command": "cmd", "args": ["/c", "uvx", "blender-mcp"] } } }command 用 cmd,是为了让 Windows 能正确解析 /c 后面的命令。args 里依次是 /c、uvx、blender-mcp。保存后 TRAE 会启动这个 MCP Server,如果右侧出现绿色对勾,说明 blender-mcp 进程已经跑起来,并通过标准输入输出与 TRAE 建立了连接。这套 JSON 在 Cursor 的 MCP 配置里同样适用,操作按钮位置略有差别,核心参数不用改。
如果一直是红色或转圈,不要反复改配置,先在终端手动执行 uvx blender-mcp。程序启动后通常会停在等待状态,看起来像卡住,这其实是 MCP 协议的正常表现。手动能启动,说明依赖没问题,问题多半出在 TRAE 没读到 PATH;手动启动时如果直接抛异常,把异常信息贴回 TRAE 会话,能更快定位。
4. 测试 AI 建模:让 TRAE 在 Blender 里生成并旋转立方体
4.1 一句指令从 TRAE 到 Blender 的完整链路
整条链路可以这样理解:TRAE 负责跟模型对话,模型负责理解“在 Blender 中新建一个立方体并旋转 30 度”并决定调用哪个工具;blender-mcp 负责把工具调用翻译成 Blender 的 Python API 操作。TRAE 与模型之间的通信,就走第 2 节里填的 TaoToken Base URL;MCP 不碰模型,也不碰 Key。
所以测试时不要一上来就写复杂的建模指令。先从最小操作开始:在 TRAE 对话框里输入“在 Blender 中新建一个立方体,然后让它绕 Z 轴旋转 30 度”。TRAE 会先把这句话发给模型,模型返回一个工具调用请求,blender-mcp 收到后让 Blender 执行。整个过程不需要你手动在 Blender 里点任何按钮,也不需要额外写 Python 代码。
4.2 看到 Blender 动了,说明 TaoToken Key 和 MCP 都通
执行后,Blender 的 3D 视口里如果出现一个默认尺寸的立方体,并且旋转属性里 Z 变成了 30 度,说明两个环节都通了:MCP 能正确操作 Blender,TaoToken Key 也确实被 TRAE 用来调用模型了。
如果 TRAE 能正常输出文字,但 Blender 没有反应,问题几乎都出在 MCP 这一段;如果 TRAE 连文字都输出不了,或者提示模型连接失败,问题则在模型配置段。用这个标准,可以快速把故障一分为二,不用每次从头排查。第一次成功之后,再逐步增加指令复杂度,比如“把立方体改为球体,材质设为金属,并绕 X 轴旋转 45 度”,每次改动都能在 Blender 里及时看到结果。后面想换新模型 ID,回到 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content= 的模型广场看列表就行,不用改 MCP 配置。
5. 报错对照与查看用量:把这次调用在控制台对一下
5.1 三个最容易翻车的点
第一个是 Blender 端插件没启用。uvx blender-mcp 能启动不算数,Blender Preferences 里必须看到 Blender MCP 处于勾选状态。第二个是 TRAE 找不到 uvx,表现为 MCP Server 红色。安装 uv 后一定要重开终端验证 uvx --version,同时重启 TRAE 让它重新读取 PATH。第三个是模型端报错。如果 TRAE 提示连接失败,先检查 Base URL 是不是写成了 https://taotoken.net/api/v1,正确写法是 https://taotoken.net/api;再检查模型 ID 是否在模型广场存在,以及 API Key 是否把 YOUR_API_KEY 替换成了真实值。
这三个问题覆盖了从 Blender、MCP 到模型通道的每一段,逐个排除后基本都能跑通。需要注意的是,把这段 JSON 放进 TRAE 后,如果第一次操作慢,不要频繁重复发送指令,blender-mcp 是按顺序执行队列的,连续发多条会让 Blender 来不及响应。
5.2 跑通之后,去控制台对一下这次调用
配置保存后,先去 TaoToken 模型对话 用同一把 Key 发一条消息,确认模型 ID 和 Base URL 都没填错;需要长期写代码再打开 Coding Plan 看套餐是否够用。Key 的状态和用量记录,可以在 控制台 API Keys 查看。后面如果要把同一把 Key 用到 Claude Code,环境变量对照见 接入文档。看到 Blender 场景里有立方体,控制台里也有这次调用记录,TRAE 跑 Blender MCP 的这条链路就算闭环了。