1. 为什么要在 Blender 里接 MCP从手动建模到自然语言驱动Blender 的建模能力很强但它的操作门槛也确实劝退了不少人。快捷键几十组、修改器面板层层嵌套想搭一个「低多边形地牢一条龙守着金币罐」这种场景光是把方块、材质、灯光摆到位就得折腾半小时。而 MCP for Blender 想解决的就是这件事让 Claude 这类支持 MCP 协议的 AI 客户端直接控制 Blender你用中文或英文描述场景AI 把它拆成 Blender 能执行的命令实时在视口里生成模型。MCP 全称 Model Context Protocol你可以把它理解成「AI 客户端和本地工具之间的一条标准数据线」。Blender 这边跑一个 MCP ServerAI 客户端这边通过配置连上它双方就能互相传指令和结果。整个链路由两部分组成一是通过uvx blender-mcp启动的 MCP Server负责在 AI 和 Blender 之间转发二是装在 Blender 内部的插件负责真正执行建模操作。这套方案适合谁想快速出简单 3D 场景的开发者、做概念草图的设计师以及想体验「对话式建模」的 Blender 用户。它不适合拿来做精细的工业级模型但用来验证创意、搭场景草稿非常顺手。本文会把从装 uv、配 Claude Desktop、装 Blender 插件到跑通第一句自然语言指令的完整链路走一遍同时用 TaoToken 统一管理多工具的 API Key避免在 Claude Desktop、Claude Code、Cursor 之间反复切换凭证。2. 前置准备uv、Blender 版本与 TaoToken 统一 Key在动手配置之前先把三样东西确认好能省掉后面一大半的排障时间。第一是 Blender 版本要求 3.0 或更新。打开 Blender在顶部菜单 Help → About Blender 里能看到版本号。低于 3.0 的版本插件接口不兼容建议先升级。第二是 Python 环境要求 3.10 或更新。MCP Server 本身跑在 Python 上版本太低会在启动时直接报错。终端里执行python --version确认一下即可。第三是包管理器 uv。MCP for Blender 依赖uvx命令来拉起服务所以必须先装 uv。这里有个坑要提前说不要用pip install uv安装官方明确提示这种方式可能存在兼容问题要用官方安装脚本。Windows 下用 PowerShell 执行powershell -ExecutionPolicy ByPass -c irm https://astral.sh/uv/install.ps1 | iexmacOS / Linux 下执行curl -LsSf https://astral.sh/uv/install.sh | sh装完后重新开一个终端执行uv --version能正常输出版本号就说明成功了。接下来是 TaoToken 的部分。如果你只用 Claude Desktop 一个客户端其实可以跳过这步但一旦你同时用 Claude Code、Cursor、Windsurf每个工具都要单独填一遍 API Key管理起来很乱。TaoToken 的作用就是把这些工具的凭证统一到一处用一个 Key 走通所有客户端。先去官网注册并拿到 Key官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content拿到 Key 之后在控制台里可以创建和管理多个 Key按项目或按工具区分。API 通道地址是https://taotoken.net/api这个地址在配置 Claude Code 或 Cursor 时会用到。模型对话、Coding Plan、API Keys 管理这几个入口分别在模型对话https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmodel_chatCoding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding_planAPI Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi_keys接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc把 Key 先复制到剪贴板备用下面配置客户端时会用到。3. 可复制配置Claude Desktop 与 Claude Code 接入 blender-mcp这一步的目标是把 MCP for Blender 注册到 AI 客户端里。不同客户端的配置文件位置和写法略有差异下面按客户端分别给出可直接复制的片段。3.1 Claude Desktop 的 config 骨架Claude Desktop 的 MCP 配置文件叫claude_desktop_config.json。Windows 下一般在%APPDATA%\Claude\目录macOS 下在~/Library/Application Support/Claude/。用编辑器打开没有就新建写入以下内容{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }保存后完全退出 Claude Desktop 再重新打开配置才会生效。注意是「完全退出」不是关窗口Windows 下要在托盘图标右键退出macOS 下用 CmdQ。如果你还想在 Claude Desktop 里通过 TaoToken 走 API 通道可以在同一个配置文件里加上环境变量段把 Key 和 base URL 注入进去{ mcpServers: { blender: { command: uvx, args: [blender-mcp], env: { TAOTOKEN_API_KEY: 你的Key, TAOTOKEN_BASE_URL: https://taotoken.net/api } } } }这样 Blender 相关的调用和模型请求都走同一个 Key后面换工具时不用再改。3.2 Claude Code 的一条命令接入Claude Code 的接入更简单不需要手写 JSON一条命令搞定claude mcp add blender uvx blender-mcp执行完后可以用claude mcp list确认 blender 已经在列表里。如果你想让 Claude Code 也走 TaoToken 的通道在启动前设置环境变量export TAOTOKEN_API_KEY你的Key export TAOTOKEN_BASE_URLhttps://taotoken.net/apiWindows PowerShell 下用$env:TAOTOKEN_API_KEY你的Key的写法。设置完再启动 Claude Code请求就会走统一通道。3.3 Cursor、Windsurf 等其他客户端其他 MCP 客户端的配置思路一致命令填uvx参数填blender-mcp。以 Cursor 为例在设置里找到 MCP Servers新增一个Command 填uvxArgs 填blender-mcp保存即可。具体字段名各客户端略有不同拿不准的时候对照接入文档里的说明改。4. 安装 Blender 插件并启动 MCP 服务客户端配好了Blender 这边还差插件。这一步分两个动作装插件、启服务。4.1 用 uvx 安装插件在终端执行uvx blender-mcp install-addon这条命令会把 Blender MCP 插件装到 Blender 的插件目录里。执行过程中如果提示找不到 Blender 路径检查一下 Blender 是否装在默认位置或者手动指定路径。4.2 在 Blender 里启用插件打开 Blender依次进入 Edit → Preferences → Add-ons在搜索框里输入Blender MCP找到Interface: Blender MCP这一项勾选前面的复选框启用。如果搜不到先确认上一步的安装命令是否执行成功再确认 Blender 版本是否在 3.0 以上实在不行重启一次 Blender 再搜。4.3 启动 MCP Server插件启用后回到 3D 视口按N键打开右侧边栏切换到BlenderMCP标签页点击Start MCP Server。服务默认监听localhost:9876。如果这个端口被别的程序占了可以通过环境变量BLENDER_HOST和BLENDER_PORT覆盖默认配置然后在客户端配置里保持一致。这里有个重要限制要记住MCP 服务同一时间只能跑一个实例。不要同时在 Cursor 和 Claude Desktop 里连同一个 Blender 服务先在一个客户端用完、断开再换另一个。否则会出现指令发出去没反应、或者两个客户端抢同一个连接的情况。5. 验证请求用一句自然语言让 Blender 生成第一个场景配置全部完成后来跑一次验证。打开 Claude Desktop或你配置好的客户端新建对话输入下面这句Create a sphere and place it above the cube发送后观察两个地方一是 Claude 的回复里会出现调用 blender 工具的痕迹二是 Blender 视口里会实时出现一个立方体上方悬浮一个球体。如果两边都有反应说明从对话到 Blender 操作的闭环已经跑通了。链路通了之后可以试更复杂的指令比如Create a low poly dungeon scene with a dragon guarding a pot of goldClaude 会把这句话拆解成一系列建模操作逐步在 Blender 里生成场景。建议先用简单指令验证链路再上复杂场景这样出问题时容易定位是链路问题还是指令理解问题。关于验证结果有几个观察点值得留意。第一Blender 视口里的对象是实时出现的不是等 AI 全部回复完才一次性生成这说明 MCP 是流式转发指令的。第二如果 Claude 回复里说调用了工具但 Blender 没反应多半是插件没启用或服务没启动回到第 4 节检查。第三如果 Blender 有反应但对象位置不对那是指令理解的问题换更明确的描述即可。安全提醒MCP for Blender 提供的execute_blender_code工具可以在 Blender 内执行任意 Python 代码。在使用 AI 生成的代码前尤其是复杂场景下先保存工程文件避免误操作丢失工作成果。养成 CtrlS 的习惯比事后撤销靠谱。6. 本篇常见错排查端口占用、插件搜不到、连接失败配置过程中最容易卡住的几个点集中在这里说清楚。问题一为什么不能用 pip 安装 uv官方 Quickstart 明确提示不要通过pip install uv安装可能存在兼容问题。直接用第 2 节的官方安装脚本即可。如果你之前用 pip 装过先卸载再重装。问题二Blender 插件列表里搜不到 Interface: Blender MCP先确认是否执行过uvx blender-mcp install-addon再确认 Blender 版本是否在 3.0 以上。如果刚执行完安装命令重启一下 Blender 再搜。还有一种情况是插件装了但没刷新在 Add-ons 页面点一下刷新按钮。问题三连接失败或端口被占用怎么办默认端口是localhost:9876被占用时通过BLENDER_HOST和BLENDER_PORT环境变量换一个端口然后在客户端配置里保持一致。比如改成 9877export BLENDER_PORT9877改完记得重启 Blender 的 MCP 服务和 AI 客户端两边端口必须一致才能连上。问题四可以同时在两个客户端里用吗不行。MCP 服务同一时间只允许运行一个实例。比如不能同时在 Cursor 和 Claude Desktop 里连接使用。切换客户端时先在原客户端断开再在新客户端连接。问题五AI 生成的场景不对或者把场景弄乱了怎么办养成先保存工程文件的习惯。execute_blender_code会在 Blender 里执行任意 Python 代码复杂场景操作前务必保存必要时可以通过撤销或重新打开文件恢复。如果场景被改乱CtrlZ 撤销通常能救回来但撤销步数有限重要节点还是手动保存稳妥。问题六Claude 回复说调用了工具但 Blender 没反应按顺序检查三点Blender 插件是否启用、MCP Server 是否已启动、客户端配置里的命令和参数是否正确。这三点是连接问题的绝大多数原因。如果都正常看一下 Blender 的 MCP 标签页里有没有连接状态提示通常会显示当前连接的客户端数量。排障过程中如果需要确认 API 通道是否正常可以去 API Keys 页面检查 Key 状态API Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi_keys接入相关的字段说明和示例参考接入文档接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc7. 多工具凭证统一TaoToken 在 MCP 工作流里的位置前面配置时你可能注意到了Claude Desktop、Claude Code、Cursor 各自都要填一遍凭证。工具一多Key 散落在各个配置文件里换一次 Key 要改好几处很容易漏。TaoToken 在这里的角色就是把这些凭证收拢到一处用一个 Key 走通所有客户端。具体做法是在 TaoToken 控制台创建一个 Key然后在每个客户端的配置里通过环境变量注入TAOTOKEN_API_KEY和TAOTOKEN_BASE_URL。这样无论你换哪个客户端底层走的都是同一个通道Key 也只需要在控制台里轮换一次。如果你主要用 Claude 做模型对话来辅助建模思路可以直接在模型对话页面测试模型对话https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmodel_chat如果你长期用 Claude Code 做编码和 Agent 任务配合 Blender MCP 做场景脚本生成Coding Plan 会更合适Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding_plan整个 MCP for Blender 的链路核心配置其实就两处客户端侧的uvx blender-mcp命令注册以及 Blender 侧的插件启用和服务启动。把这两处配好再用 TaoToken 统一 Key 管理多工具凭证后面无论加多少客户端都不用再重复折腾凭证。遇到连接问题先查插件是否启用、服务是否启动、端口是否一致这三点基本能覆盖大部分情况。