1. 为什么要在 Cursor 里复现 BlenderMCP 并接入 TaoTokenBlenderMCP 是 GitHub 上一个把 Blender 变成「可被 AI 调用工具」的开源项目全称 Blender Model Context Protocol Integration。它做的事情很直接在 Blender 里跑一个 MCP Server把建模、改材质、加物体这些操作暴露成标准工具接口然后让 Cursor 这类支持 MCP 的客户端去调用。你只要在 Cursor 的 Chat 里说一句「add a cube to my scene」Blender 那边就会真的多出一个立方体。这个流程里有两个独立的通道需要打通。第一个是 MCP 通道负责 Cursor 和 Blender 之间的工具调用走的是本地 stdio 或端口通信这部分 BlenderMCP 项目本身已经处理好了。第二个是模型调用通道也就是 Cursor 里那个「大脑」到底连到哪个模型服务。很多人复现到一半卡住不是 MCP 配错了而是模型通道没统一导致 Cursor 发不出请求或者返回一堆报错。我这次的做法是把模型调用通道统一到 TaoToken。TaoToken 是一个兼容 OpenAI 接口规范的模型调用入口Base URL 是https://taotoken.net/api你拿一个 Key 就能在 Cursor、Cline、Codex 这些工具里复用同一套配置。对于 BlenderMCP 这种「客户端 本地服务端」的组合来说把模型通道收敛到一个入口排障会简单很多MCP 绿点不亮就查 Blender 侧Chat 没响应就查 TaoToken 侧的 Key 和 Base URL。适合跟着做的人已经在本地装了 Blender 3.0 和 Cursor想用自然语言驱动 Blender 做建模自动化但被 MCP 配置和模型通道绕晕的人。整篇的节奏是先把 Blender 侧的 addon 装好、MCP Server 起起来再回到 Cursor 填 MCP 配置和模型配置最后发一条建模指令验证整条链路。全程命令和配置片段都可以直接复制。需要提前说明一点BlenderMCP 的 MCP Server 是跑在你本机的TaoToken 只负责模型调用这一段两者职责不重叠。你不需要把 Blender 暴露到公网也不需要在 Blender 里填任何 Key。Key 只出现在 Cursor 的模型配置里。2. TaoToken 前置准备Key、Base URL 与 uv 环境在动 Cursor 之前先把两样东西备齐TaoToken 的 API Key以及 BlenderMCP 依赖的 uv 包管理器。这两样缺一个后面都会卡住。先说 TaoToken 这边。打开https://taotoken.net/api-keys登录后创建一个 API Key。这个 Key 就是后面填进 Cursor 模型配置里的凭证。创建完先复制出来放好页面刷新后不一定还能完整看到。Base URL 固定用https://taotoken.net/api注意结尾不要多加/v1Cursor 的 OpenAI 兼容模式会自己拼路径多写反而会 404。模型 ID 这块Cursor 里需要填一个具体的模型名。你可以先去https://taotoken.net/models看一下当前可用的模型列表挑一个你熟悉的比如常见的对话模型 ID。这个 ID 后面会出现在 Cursor 的模型设置里也会出现在 MCP 配置的 env 段里如果你想让 MCP 服务端也走同一个通道。三个要素记牢Base URL、API Key、Model ID这就是后面反复用到的「三件套」。再说 uv。BlenderMCP 的 MCP Server 是用uvx blender-mcp这条命令拉起来的uvx 是 uv 工具链里的执行器。所以你得先有 uv。macOS 上用 Homebrew 装brew install uvWindows 上用 pip 装pip install uv装完之后验证一下直接在终端敲uv如果出现 uv 的帮助信息和使用说明说明装好了。如果提示 command not found检查一下 PATH或者重开一个终端窗口。这一步看着简单但后面 Cursor 拉起 MCP Server 时如果找不到 uvx绿点就不会亮所以先在这里确认。Blender 本身建议 3.0 或更新版本Python 3.10 以上。这两个版本要求来自 BlenderMCP 项目本身低于这个版本 addon 可能加载失败。Blender 去官网下安装包正常装就行Cursor 也是常规安装这里不展开。还有一个前置动作容易被忽略把 BlenderMCP 项目里的addon.py下载到本地。这个文件在 GitHub 项目的源文件列表里直接下载保存到一个你记得住的目录比如~/Downloads/addon.py。后面要在 Blender 里从这个文件安装插件。到这里TaoToken 的 Key、Base URL、Model ID 有了uv 装好并验证过了addon.py 也下载了。可以进入配置环节。3. 可复制配置Blender addon、Cursor MCP 与模型通道这一节是整篇的核心分三块Blender 侧装 addon 并起 MCP ServerCursor 侧填 MCP 配置Cursor 侧填模型通道配置。每一块都给可复制的片段。3.1 Blender 侧安装 addon.py 并启动 MCP Server打开 Blender点顶部菜单的 Edit进 Preferences切到 Add-ons 标签。右上角有个下拉箭头点开选 Install from Disk然后找到你刚才下载的addon.py选中加载。加载成功后在 Add-ons 列表里能搜到 BlenderMCP 相关的条目把前面的勾打上启用。回到 Blender 主界面把鼠标放到 3D 视图里按N键唤出右侧边栏。边栏里会多出一个 BlenderMCP 面板里面有一个Start MCP Server按钮点它。点了之后 Blender 会在本地起一个 MCP Server默认监听本地端口。面板上一般会显示运行状态看到它变成运行中就行。这一步的坑在于如果你按 N 没看到面板多半是 addon 没启用成功回 Preferences 里确认勾选状态。如果点了 Start 没反应看 Blender 底部的系统控制台有没有报错常见的是 Python 版本不匹配。3.2 Cursor 侧MCP 配置片段打开 Cursor进设置找到 MCP 这一栏。新建一个 MCP Server名字随便起比如BlenderMCP。类型选command命令填{ mcpServers: { BlenderMCP: { command: uvx, args: [blender-mcp], env: { TAOTOKEN_BASE_URL: https://taotoken.net/api, TAOTOKEN_API_KEY: 你的_TaoToken_Key, TAOTOKEN_MODEL_ID: 你的_Model_ID } } } }这段 JSON 就是 Cursor 的 MCP 配置文件内容。路径上macOS 一般在~/.cursor/mcp.jsonWindows 在%APPDATA%\Cursor\mcp.json你也可以直接在 Cursor 的 MCP 设置界面里粘贴。注意command是uvxargs是[blender-mcp]这跟项目 README 里给的一致。env 段里的三个变量是可选的取决于 BlenderMCP 的 MCP Server 是否需要自己调模型。如果你的用法是「Cursor 负责调模型MCP 只负责转发工具调用」那 env 可以不填。但如果你想让 MCP 服务端也走 TaoToken 通道就把 Base URL、Key、Model ID 按上面填进去。三件套在这里一次性写全后面换工具也不用改。保存后回到 MCP 列表如果BlenderMCP前面是绿点说明 Cursor 成功拉起了这个 MCP Server。绿点不亮就往下看第 5 节的排障。3.3 Cursor 侧模型通道配置MCP 只是工具通道Cursor 的 Chat 还得有个模型来理解你的指令。进 Cursor 设置里的 Models 部分把模型提供商切到 OpenAI 兼容模式然后填Base URLhttps://taotoken.net/apiAPI Key你的 TaoToken KeyModel你的 Model ID有些版本的 Cursor 把这块放在settings.json里对应字段是openai.baseUrl和openai.apiKey。如果你用的是 Cline 或 Codex 这类工具配置位置不同但三件套一样Base URL、Key、Model ID。比如 Codex 的auth.json里就是这几个字段Cline 的 MCP 设置里也是同样的结构。配置完保存Cursor 会做一次连通性检查。如果模型列表能拉出来说明通道通了。拉不出来就检查 Base URL 结尾有没有多写/v1以及 Key 有没有复制全。三块配置做完Blender 侧 MCP Server 在跑Cursor 侧 MCP 绿点亮着模型通道也通了。可以发指令验证了。4. 验证请求从 Cursor 发建模指令到 Blender 返回结果验证分两步先确认 MCP 工具能被 Cursor 识别再发一条真实的建模指令看 Blender 有没有反应。第一步在 Cursor 里打开 Chat 模式输入一句简单的探测指令比如list available tools如果 MCP 配置正确Cursor 会返回 BlenderMCP 暴露的工具列表通常包括创建物体、修改材质、执行脚本之类的条目。看到这个列表说明 Cursor 已经能通过 MCP 通道跟 Blender 对话了。这一步不涉及模型生成纯粹是工具发现。第二步发一条真正的建模指令。我试过最稳的是add a cube to my scene发出去之后Cursor 会把这句话交给模型理解模型决定调用 BlenderMCP 的哪个工具然后通过 MCP 通道把调用转发给 Blender。Blender 那边执行完场景里会多出一个立方体。你切回 Blender 的 3D 视图就能看到。如果立方体出现了整条链路就通了Cursor Chat → 模型通道TaoToken→ MCP 工具调用 → Blender 执行 → 结果返回。这时候可以试更复杂的指令比如Please add a little house to my scene这条会触发多个工具调用先建主体再建屋顶效果不一定精致但能验证多步调用是通的。实测下来复杂指令的成败很大程度取决于模型对工具描述的理解所以 Model ID 选一个指令遵循能力好的会顺很多。验证阶段有两个观察点。一是 Cursor 的 Chat 里会显示它调用了哪些工具你能看到blender_mcp之类的调用记录。二是 Blender 底部的控制台会打印执行日志能看到脚本被执行。两边都有输出才算真正跑通。如果指令发出去了但 Blender 没动静先看 Cursor Chat 里有没有报错再看 Blender 控制台。常见的是 MCP 绿点掉了或者模型通道返回了错误。下一节集中排。5. 本篇常见错排查401、local proxy failed 与绿点不亮复现过程中最容易撞上的几类报错这里按现象对照原因给排查路径。401 Unauthorized。这个基本都出在模型通道。原因通常是 TaoToken 的 Key 没填对、填错位置或者 Key 被复制时带了空格。排查进 Cursor 的模型设置把 Key 重新粘贴一遍确认 Base URL 是https://taotoken.net/api而不是别的。如果用的是 Cline 或 Codex检查对应的auth.json或 MCP 配置里的 Key 字段。401 不会因为 MCP 配置错而出现所以看到 401 直接查模型通道。local proxy failed。这个报错通常出现在 Cursor 尝试连接本地 MCP Server 的时候。原因可能是 Blender 侧的 MCP Server 没起来或者端口被占用。排查回 Blender 看 BlenderMCP 面板是不是还在运行中如果停了就重新点 Start MCP Server。然后确认 Cursor 的 MCP 配置里command是uvx、args是[blender-mcp]没有多余字符。如果之前起过多个实例重启一下 Cursor 和 Blender。reading choices 相关报错。这类多半是模型返回格式和 Cursor 预期不一致。排查确认 Model ID 填的是 TaoToken 支持的对话模型而不是 embedding 或别的类型。有些模型对工具调用的支持不完整换一个指令遵循更好的 Model ID 通常能解决。MCP 绿点不亮。先确认 uv 装好了终端敲uv有输出。再确认uvx blender-mcp这条命令能单独在终端跑起来。如果终端能跑但 Cursor 里不亮多半是 Cursor 的环境变量没继承到 uv 的路径重启 Cursor 或者把 uv 的路径写进 MCP 配置的 env 里。OAuth 相关报错。如果你在配置里误开了 OAuth 流程而 TaoToken 用的是 Key 认证就会撞上这个。排查确认模型通道用的是 API Key 模式不是 OAuth。Cursor 的模型设置里如果有认证方式选项选 API Key。Blender 里按 N 没面板。回 Preferences 的 Add-ons 确认 BlenderMCP 勾选了。如果列表里根本没有说明 addon.py 没加载成功重新 Install from Disk 一次。排障的通用思路是分层MCP 层的问题看绿点和 Blender 控制台模型层的问题看 401 和 choices 报错。两层分开查不要混在一起猜。三件套Base URL、Key、Model ID在任何一层出问题时都值得重新核对一遍。6. 把通道固定下来后续复现与工具切换跑通一次之后建议把配置固定成模板后面复现别的 GitHub MCP 项目时直接套。核心就是那三件套Base URL 用https://taotoken.net/apiKey 用你创建的那个Model ID 按项目需要选。MCP 配置的结构在 Cursor、Cline、Codex 之间大同小异都是 command args env 的组合换项目时只改 command 和 argsenv 里的三件套不动。BlenderMCP 这个项目本身还在迭代addon.py 和 MCP Server 的命令偶尔会变。复现时以 GitHub 项目 README 为准如果uvx blender-mcp拉不起来去看项目有没有更新启动方式。TaoToken 这边 Base URL 和 Key 的用法是稳定的模型列表可以去https://taotoken.net/models查最新的。如果你后面想把这套用到长期编码或 Agent 场景可以了解下 Coding Plan 这类用法把模型通道和工具链统一管理。验证模型本身的能力可以直接在模型对话里试。接入文档在https://taotoken.net/doc配置细节都在里面。最后留一个实用习惯每次改完 MCP 或模型配置先发list available tools探测再发建模指令。探测通过说明工具通道没问题建模失败就只查模型层能省不少来回。Blender 控制台和 Cursor Chat 两边的日志对着看问题定位会快很多。