我要提问
ARTICLE DETAIL

资讯详情

前沿编程新知与开发实战干货的深度解读。

BlenderMCP 实战:用 TaoToken 统一 Key 打通 3D 建模 AI 员工工作流

BlenderMCP 实战:用 TaoToken 统一 Key 打通 3D 建模 AI 员工工作流 1. BlenderMCP 到底是什么为什么 3D 建模需要它BlenderMCP 是一个把 Blender 和 AI 大模型连起来的开源桥接工具全称是 Blender Model Context Protocol。简单说它让 AI 能直接“看见”你 Blender 里的场景并且能动手帮你创建、修改、删除 3D 对象。你不需要在 Blender 和聊天窗口之间来回复制粘贴 Python 代码AI 通过 MCP 协议就能直接操作 Blender。它适合谁三类人最受益一是刚学 Blender 但写不好 Python 脚本的建模新手二是需要快速搭场景草图的游戏/影视从业者三是想把 3D 建模接入自动化工作流的开发者。我自己在做一个低多边形游戏场景时用 BlenderMCP 把“搭一个地下城房间”这件事从半小时压缩到了几分钟。BlenderMCP 的核心能力包括双向通信通过 TCP 套接字把 AI 和 Blender 连起来、对象操作创建/修改/删除 3D 对象、材质控制应用和修改材质颜色、场景检查获取当前场景详细信息、代码执行在 Blender 里跑任意 Python 代码。它由两部分组成Blender 插件addon.py负责在 Blender 内建一个套接字服务器接收命令MCP 服务器src/blender_mcp/server.py负责实现 MCP 协议并连接插件。通信协议是简单的 JSON over TCP命令带type和可选params响应带status和result或message。工具集包括get_scene_info、get_object_info、create_primitive、set_object_property、create_object、modify_object、delete_object、set_material、execute_blender_code。但这里有个现实问题BlenderMCP 默认走 Claude 桌面端的 MCP 配置而很多国内开发者用的是 Claude Code、Cline、Codex 这类编码工具或者需要统一管理多个模型的 Key。这时候就需要一个统一的 API 通道来承接模型调用和鉴权。TaoToken 就是干这个的——它提供统一的 Key 和 API 通道让你在 BlenderMCP 的 MCP 配置里填一次 Base URL 和 Key就能切换不同模型不用每个工具单独配。我实测下来把 BlenderMCP 的模型调用指向 TaoToken 的 API 通道后配置从“每个工具一套 Key”变成“一个 Key 走天下”而且鉴权失败时排查路径也清晰很多。下面我会从插件安装、MCP 服务启动、TaoToken 配置、验证请求到排错一步步带你跑通。2. TaoToken 前置准备统一 Key 与 API 通道配置在开始配 BlenderMCP 之前先把 TaoToken 的 Key 和 API 通道准备好。这一步是整个链路的地基地基没打好后面 Blender 端连不上会很难排查。首先你需要一个 TaoToken 账号然后去控制台创建 API Key。访问https://taotoken.net/api-keys记得带上 UTM 参数方便归因在页面里点“创建 Key”复制生成的 Key 字符串。这个 Key 就是后面 MCP 配置里的api_key字段。注意Key 只显示一次复制后存到安全的地方别直接提交到 Git。TaoToken 的 API 基础地址是https://taotoken.net/api这个地址不加 UTM直接作为 Base URL 用。它的作用是统一承接模型调用请求你不需要为每个模型单独配不同的 endpoint。比如你想用 Claude 系列模型做 BlenderMCP 的推理后端就在 TaoToken 里选对应模型MCP 配置里填 TaoToken 的 Base URL 和 Key 就行。这里有个关键点BlenderMCP 的 MCP 服务器本身不直接调模型它是通过 MCP 客户端比如 Claude Code、Cline、Codex来调模型的。所以你要配的是 MCP 客户端的模型通道而不是 Blender 插件本身。换句话说Blender 插件只管和 MCP 服务器通信MCP 服务器只管和 Blender 通信真正调模型的是你的编码工具或 Claude 桌面端。我建议你先在 TaoToken 控制台确认三件事一是 Key 有余额或额度二是选好了要用的模型 ID比如claude-sonnet-4-20250514这类三是记下 Base URLhttps://taotoken.net/api。这三样东西后面会反复用到。如果你用的是 Claude Code 或 Cline 这类工具它们的 MCP 配置里需要填 Base URL、API Key、Model ID 三件套。TaoToken 的文档页https://taotoken.net/doc有详细的接入说明建议先扫一眼。另外如果你想先验证模型通道是否通可以去https://taotoken.net/models用模型对话功能发一条测试消息确认 Key 和模型都能正常工作。踩过的坑有人把 TaoToken 的 Key 填到了 Blender 插件的配置里但 Blender 插件根本没有 Key 字段它只负责套接字通信。Key 要填在 MCP 客户端的配置里。这个混淆会导致“Blender 连上了但模型不响应”的假象。3. 可复制配置Blender 插件 MCP 服务器 TaoToken 三件套这一节是核心操作部分我会给出完整的可复制配置片段。你需要按顺序做三件事装 Blender 插件、配 MCP 服务器、把模型通道指向 TaoToken。3.1 安装 Blender 插件 addon.py先从 GitHub 仓库https://github.com/ahujasid/blender-mcp下载addon.py。打开 Blender进入Edit Preferences Add-ons点右上角Install...选择下载好的addon.py。安装后勾选启用Interface: Blender MCP。启用后在 Blender 3D 视图右侧按N键会看到一个新的BlenderMCP面板。在面板里点Connect to MCP server默认端口是9876。这时候 Blender 插件就在本地起了一个 TCP 套接字服务器等待 MCP 服务器发命令。你可以在 Blender 的 Python Console 里跑一句import socket; ssocket.socket(); s.connect((localhost,9876)); print(ok)来确认端口通了。3.2 配置 MCP 服务器 blender-mcpMCP 服务器用uvx启动命令是uvx blender-mcp。如果你还没装uv先装pip install uv。然后确认uvx可用uvx --version。接下来是 MCP 客户端的配置。以 Claude Code 为例它的 MCP 配置在~/.claude/claude_desktop_config.json或项目级的.mcp.json。如果你用的是 Cline配置在 VS Code 的settings.json里。下面给出一个通用的 MCP 配置 JSON 片段路径和字段名按你的工具调整{ mcpServers: { blender: { command: uvx, args: [blender-mcp], env: { BLENDER_HOST: localhost, BLENDER_PORT: 9876 } } } }这段配置的意思是MCP 客户端启动一个uvx blender-mcp进程这个进程会去连localhost:9876的 Blender 插件。注意env里的BLENDER_HOST和BLENDER_PORT要和 Blender 插件面板里显示的一致。3.3 把模型通道指向 TaoToken现在关键一步MCP 客户端调模型时要走 TaoToken 的 API 通道。以 Claude Code 为例它的模型配置在~/.claude/settings.json或环境变量里。你需要设置三件套{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: 你的TaoTokenKey, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }如果你用的是 Codex它的配置在~/.codex/auth.json格式类似{ base_url: https://taotoken.net/api, api_key: 你的TaoTokenKey, model: claude-sonnet-4-20250514 }Cline 的配置在 VS Codesettings.json里搜cline.apiProvider选Anthropic然后填 Base URL、API Key、Model ID。三件套缺一不可Base URL 是https://taotoken.net/apiAPI Key 是 TaoToken 控制台生成的Model ID 是你要用的模型。这里要强调Base URL 后面不要加/v1或/chat/completionsTaoToken 的通道会自动路由。我试过加/v1导致 404去掉就通了。配置完成后重启 MCP 客户端让它重新加载配置。然后在客户端里发一条消息比如“列出当前 Blender 场景里的所有对象”看它能不能调get_scene_info工具。4. 验证请求一次完整的 AI 驱动建模指令配置好了现在来跑一次完整验证。这一步会确认整条链路MCP 客户端 → TaoToken 模型通道 → MCP 服务器 → Blender 插件 → Blender 场景。先确保 Blender 开着插件面板显示Connected。然后在 MCP 客户端里输入这条指令获取当前场景信息然后创建一个地下城中的低多边形场景有一条龙守护着一锅金币。MCP 客户端会先调get_scene_info拿到当前场景的对象列表。然后模型会规划一系列工具调用create_primitive创建地面和墙壁create_object创建龙和金币锅set_material给龙上红色材质、给金币上金色材质。你会在 Blender 视图里实时看到对象一个个出现。如果一切正常Blender 的 Python Console 会打印出类似这样的日志Received command: {type: get_scene_info} Sending response: {status: success, result: {...}} Received command: {type: create_primitive, params: {primitive_type: cube, location: [0,0,0]}} ...同时 MCP 客户端会显示工具调用成功的返回。你可以继续发第二条指令获取当前场景信息并从中创建一个 threejs 草图。这条指令会触发get_scene_info和execute_blender_code模型会生成一段 Three.js 代码来复现当前场景。你可以在客户端里看到生成的代码复制到 Three.js 编辑器里就能看到 3D 预览。验证成功的标志有三个一是 Blender 视图里对象真的变了二是 MCP 客户端没有报错三是 TaoToken 控制台的用量统计里能看到这次请求的 token 消耗。如果三者都满足说明链路完全通了。我实测下来从发指令到 Blender 里出现完整场景大概 20 到 40 秒取决于模型响应速度和场景复杂度。低多边形场景通常更快高精度模型会慢一些。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节列出你大概率会遇到的报错和对应解法。每个报错我都附上真实错误信息和排查路径。401 Unauthorized这是最常见的鉴权失败。错误信息通常是{error: {type: authentication_error, message: invalid api key}}。原因有三个一是 TaoToken Key 填错了或过期了二是 Base URL 填成了https://taotoken.net/api/带了尾斜杠三是 Key 前面多了空格。排查方法去 TaoToken 控制台重新生成一个 Key复制时确认没有多余字符Base URL 严格写成https://taotoken.net/api。local proxy failed这个报错通常出现在 MCP 客户端启动时信息是MCP error -32000: Connection closed或local proxy failed to start。原因是uvx blender-mcp进程没起来。排查先在终端手动跑uvx blender-mcp看有没有报错。如果提示找不到命令说明uv没装好如果提示端口被占用改 Blender 插件面板里的端口同时改 MCP 配置里的BLENDER_PORT。reading choices 报错错误信息类似Error reading choices: Expecting value: line 1 column 1。这是模型返回的响应格式不对通常是 Base URL 指向了一个不兼容的 endpoint。排查确认 Base URL 是https://taotoken.net/api不要加/v1。另外确认 Model ID 是 TaoToken 支持的模型去https://taotoken.net/models查可用列表。OAuth 相关报错如果你用的是 Claude Code 且开了 OAuth 登录可能会和 API Key 模式冲突报OAuth token invalid或conflicting auth methods。解法在 Claude Code 里退出 OAuth 登录改用 API Key 模式即设置ANTHROPIC_API_KEY环境变量。如果你用的是 Codex检查~/.codex/auth.json里不要同时有 OAuth token 和 api_key。Blender 插件连不上MCP 客户端报Connection refused到localhost:9876。排查确认 Blender 插件面板里点了Connect to MCP server且端口和 MCP 配置里一致。如果 Blender 重启过插件可能没自动重连需要手动再点一次。模型不调工具MCP 客户端连上了但模型只聊天不调 Blender 工具。原因是模型不知道有这些工具或者 MCP 服务器没把工具列表注册上去。排查在客户端里问“你有哪些工具可用”看它列不列得出get_scene_info等。如果列不出重启 MCP 客户端确认uvx blender-mcp进程在跑。6. 把 BlenderMCP 接入你的 AI 员工工作流跑通单次建模指令后你可以把 BlenderMCP 接入更完整的 AI 员工工作流。核心思路是用 TaoToken 统一 Key 管理多个 MCP 服务器和多个模型让 AI 员工在不同工具间切换时不用重复配鉴权。具体做法在 MCP 客户端里配多个 MCP 服务器比如blender、filesystem、database每个服务器负责一类工具。模型通道统一走 TaoToken这样你换模型时只改一个地方。比如从 Claude 切到别的模型做批量场景生成只改ANTHROPIC_MODEL字段Blender 插件和 MCP 服务器都不用动。如果你要做长期编码或 Agent 工作流建议用 TaoToken 的 Coding Plan它提供更稳定的通道和额度管理。访问https://taotoken.net/coding-plan了解详情。对于需要频繁调模型的 3D 建模场景Coding Plan 的额度池比按次计费更划算。另外BlenderMCP 的execute_blender_code工具能跑任意 Python 代码这意味着你可以让 AI 员工自动执行批量建模脚本。比如“把当前场景里所有立方体替换成低多边形树”模型会生成 Python 代码并通过execute_blender_code执行。这个能力配合 TaoToken 的统一通道可以搭出一个自动化的 3D 资产生产流水线。最后给一个实用技巧在 Blender 里把常用操作录成 Python 脚本存到项目目录然后让 AI 员工通过execute_blender_code调用这些脚本。这样模型不用每次从零生成代码响应更快结果也更稳定。TaoToken 的接入文档https://taotoken.net/doc里有更多关于多工具协同的配置示例建议对照着调一遍。
返回列表