MCP for Blender 接入教程:用 Claude 自然语言控制 Blender 的完整配置步骤

发布时间:2026/9/6 2:01:54
MCP for Blender 接入教程:用 Claude 自然语言控制 Blender 的完整配置步骤 MCP for Blender 接入教程用 Claude 自然语言控制 Blender 的完整配置步骤关键词MCP for Blender、blender-mcp、Claude Desktop、MCP Server、uvx、Blender 插件、3D 场景生成、MCP 配置摘要本文分享 MCP for Blender 的完整接入流程从安装 uv 包管理器、在 Claude Desktop / Claude Code 中配置 MCP Server到安装并启用 Blender 插件、启动 MCP 服务最后用一句自然语言让 AI 生成第一个 3D 场景。整个流程 4 步即可完成照着操作即可跑通。正文大家好 这里是「代码简单说」这篇文章主要分享一下 MCP for Blender 的接入方法。Blender 建模本身上手门槛不低菜单多、快捷键多很多简单场景比如放一个方块、搭一个低多边形场景其实用语言描述就够了。MCP for Blender 解决的就是这个问题让 Claude 或其他支持 MCP 的 AI 客户端直接控制 Blender你用自然语言下指令AI 转成 Blender 命令实时建场景。下面按官方 Quickstart 的 4 个步骤把完整配置流程走一遍。一、MCP for Blender 是什么MCP for Blender 是一个把 Blender 接入 MCPModel Context Protocol生态的方案由两部分组成MCP Server通过uvx blender-mcp启动负责在 AI 客户端和 Blender 之间转发指令Blender 插件装在 Blender 内部负责接收指令并在 Blender 里执行。配置完成后你可以直接在 Claude 里输入类似「创建一个低多边形地牢场景有一条龙守着一罐金币」的描述AI 会自动拆解成建模操作在 Blender 里实时生成场景。适合的人群想快速出简单 3D 场景的开发者、设计师以及想体验「AI 驱动建模」的 Blender 用户。二、准备工作开始之前确认三个前置条件项目要求Blender3.0 或更新版本Python3.10 或更新版本包管理器uv下文会安装另外确认你的 AI 客户端Claude Desktop、Claude Code、Cursor 等已经安装并能正常使用。三、安装 uv 包管理器MCP for Blender 依赖uvx命令来启动 MCP Server所以第一步先装 uv。注意不要用pip install uv安装官方明确提示这种方式可能有兼容问题要用官方安装脚本。Windows 下用 PowerShell 执行powershell-ExecutionPolicy ByPass-cirm https://astral.sh/uv/install.ps1 | iexmacOS / Linux 下执行curl-LsSfhttps://astral.sh/uv/install.sh|sh安装完成后重新打开一个终端执行uv --version能正常输出版本号即可。四、在 AI 客户端中配置 MCP Server这一步的目的是把 MCP for Blender 注册到你的 AI 客户端里。根据你用的客户端选一种配置即可。1. Claude Desktop打开 Claude Desktop 的 MCP 配置文件claude_desktop_config.json加入以下内容{mcpServers:{blender:{command:uvx,args:[blender-mcp]}}}保存后重启 Claude Desktop 生效。2. Claude CodeClaude Code 只需要一条命令claude mcpaddblender uvx blender-mcp3. Cursor、Windsurf 等其他客户端其他 MCP 客户端的接入方法可以参考官网的 MCP Clients 页面https://mcp-for-blender.com 配置思路一致命令填uvx参数填blender-mcp。五、安装并启用 Blender 插件光配置 AI 客户端还不够Blender 侧还需要装对应的插件。1. 执行安装命令在终端执行uvx blender-mcp install-addon2. 在 Blender 中启用插件打开 Blender依次操作进入Edit → Preferences → Add-ons搜索Interface: Blender MCP勾选复选框启用。六、启动 MCP 服务并连接插件启用后回到 Blender 的 3D 视口按N键打开侧边栏切换到BlenderMCP标签页点击Start MCP Server。服务默认监听localhost:9876。如果端口有冲突可以通过BLENDER_HOST和BLENDER_PORT两个环境变量覆盖默认配置。一个重要限制MCP 服务同一时间只能跑一个实例。不要同时在 Cursor 和 Claude Desktop 里连同一个 Blender 服务先在一个客户端用完再换另一个。七、开始使用第一句 Prompt全部配置完成后打开你的 AI 客户端直接用自然语言下指令。官方给了几个示例Create a low poly dungeon scene with a dragon guarding a pot of goldCreate a beach scene using HDRIs, textures, and vegetation from Poly HavenCreate a sphere and place it above the cubeAI 会把你的描述拆解成一系列 Blender 命令场景实时生成。建议先用「Create a sphere and place it above the cube」这种简单指令验证链路通了再上复杂场景。安全提醒MCP for Blender 提供的execute_blender_code工具可以在 Blender 内执行任意 Python 代码。在使用 AI 生成的代码前尤其是复杂场景下先保存你的工程文件避免误操作丢失工作成果。八、常见问题1. 为什么不能用 pip 安装 uv官方 Quickstart 明确提示不要通过pip install uv安装可能存在兼容问题。直接用本文第三节的官方安装脚本即可。2. Blender 插件列表里搜不到 Interface: Blender MCP先确认是否执行过uvx blender-mcp install-addon再确认 Blender 版本是否在 3.0 以上。如果刚执行完安装命令重启一下 Blender 再搜。3. 连接失败或端口被占用怎么办默认端口是localhost:9876被占用时通过BLENDER_HOST和BLENDER_PORT环境变量换一个端口然后在客户端配置里保持一致。4. 可以同时在两个客户端里用吗不行。MCP 服务同一时间只允许运行一个实例比如不能同时在 Cursor 和 Claude Desktop 里连接使用。5. AI 生成的场景不对或者把场景弄乱了怎么办养成先保存工程文件的习惯。execute_blender_code会在 Blender 里执行任意 Python 代码复杂场景操作前务必保存必要时可以通过撤销或重新打开文件恢复。九、总结以上就是 MCP for Blender 的完整接入教程整体流程 4 步安装 uv → 在 AI 客户端注册 MCP Server → 安装并启用 Blender 插件 → 在 Blender 里启动 MCP 服务。之后就可以用自然语言让 AI 在 Blender 里建场景了。核心配置就两处客户端侧的uvx blender-mcp命令注册以及 Blender 侧的插件启用和服务启动。如果遇到连接问题先检查插件是否启用、MCP 服务是否已启动、端口配置是否一致这三点。参考文档MCP for Blender Quickstart https://mcp-for-blender.com/quickstart