如何让AI直接在Blender里建模BlenderMCP完整配置指南【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcpBlenderMCP 是一个基于 Model Context ProtocolMCP的社区开源项目它把 Blender 3D 连接到 Claude 等 AI 助手让你用自然语言实时创建、修改和查询 3D 场景。整条链路只需要装一个 Blender 插件、写几行 MCP 配置就能跑通——本文讲清楚它的工作原理、三步接入流程以及连接后能调用的完整能力清单。链路上的三个角色每个文件负责什么BlenderMCP 的接入被拆成三层各自对应仓库里一个具体文件AI 客户端Claude Desktop、Cursor、VS Code 或 Claude Code CLI它们不需要懂任何 Blender 知识只负责走 MCP 协议。MCP 服务器src/blender_mcp/server.py 暴露出场景查询、对象操作、视口截图、代码执行、资产下载等一系列工具AI 在对话时直接调用这些工具。Blender 插件addon.py 在 Blender 内部启动一个 socket 服务默认localhost:9876与服务器之间用 JSON 走 TCP 通信。AI 客户端 --MCP-- MCP 服务器 (server.py) --TCP:9876-- Blender 插件 (addon.py)也就是说当你对 AI 说“把这台车改成红色金属材质”时指令会经过 MCP 服务器翻译成具体命令在你本地的 Blender 里执行再把结果返回给 AI 核对。这正是它支持双向交互的原因——AI 不只是生成代码还能拿到执行反馈。三步装好uv、插件、客户端配置第 1 步安装 uv提供uvx命令前置要求Blender 3.0 以上推荐 4.x / 5.x且必须是普通 GUI 窗口blender -b后台模式不行、Python 3.10 以上、uv。按平台安装 uvmacOSbrew install uvLinuxcurl -LsSf https://astral.sh/uv/install.sh | shWindowsPowerShell 里运行powershell -c irm https://astral.sh/uv/install.ps1 | iex并把USERPROFILE\.local\bin加入 PATH注意不要用pip install uv——它可能不会生成uvx命令。第 2 步安装 Blender 插件从仓库拿到addon.py也可以把整个仓库 clone 下来git clone https://gitcode.com/GitHub_Trending/bl/blender-mcp在 Blender 里进入 编辑 → 偏好设置 → 插件 → 安装…选择addon.py然后启用Interface: Blender MCP。第 3 步配置 AI 客户端以 Claude Desktop 为例在claude_desktop_config.json设置 → 开发者 → Edit Config中加入{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }Cursor、VS Code 用相同结构Windows 上需要写成command: cmd、args: [/c, uvx, blender-mcp]。Claude Code CLI 更省事一条命令即可claude mcp add blender uvx blender-mcp。有一点容易踩坑MCP 服务器不需要你手动启动客户端会自己拉起uvx同时只让一个客户端挂着这个服务器Cursor 和 Claude Desktop 二选一。从连接到第一次建模侧边栏点一下配置完成后在 Blender 里按N打开 3D 视图侧边栏找到 BlenderMCP 选项卡按需勾选Poly Haven开启资产下载功能点击Connect to Claude。AI 客户端一侧出现小锤子图标就说明 Blender 工具已激活。这时直接输入自然语言指令就能开工比较典型可用的说法“创建一个低多边形地牢让一条龙守着一堆金币”“把这张参考图复刻成 Blender 场景”把图片发给 AI 即可“把这辆车改成红色金属材质”“影棚布光等距视角相机”复杂任务里AI 还能“看到”场景get_viewport_screenshot会把当前视口截图作为图片返回给 AI它在动手前先观察现状更接近人类建模的工作方式。能力清单不止“做点东西”server.py 里的工具列表决定了 BlenderMCP 的能力上限大致分四类场景查询与对象控制get_scene_info和get_object_info分别查询整个场景或单个对象的位置、材质、参数创建、移动、缩放、删除对象都是常规操作。另外还有一个execute_blender_code工具可以直接在 Blender 里执行任意 Python——这是上限最高的能力也是风险最高的官方提示使用前先保存作品。材质与环境Poly Haven通过 API 搜索和下载 HDRI、纹理、3D 模型侧边栏勾选开关后即可使用比如“用一张海滩 HDRI 做环境光照”。set_texture给指定对象应用纹理。资产库与 AI 模型生成Sketchfab搜索、预览并导入现成模型需 API Key。Hyper3D Rodin文本生成 3D、图片生成 3D免费额度有每日限制。Hunyuan3D腾讯的 3D 生成服务凭据在插件偏好里配置。生成结果通过import_generated_asset类工具导入场景。Sketchfab、Hyper3D、Hunyuan3D 的 API Key 都存在 Blender 的插件偏好面板里重启后仍然有效。常见问题排查表症状处理方式spawn uvx ENOENTGUI 客户端不继承终端 PATH用which uvxmacOS/Linux或where uvxWindows取完整路径填到command字段Apple Silicon 构建报错cryptography wheel在 args 里指定 arm64 Python[--python, 3.11-aarch64, blender-mcp]连接后第一条指令失败常见现象重试一次即可指令超时把大请求拆成几个小指令依次执行Python 版本冲突args 加[--python, 3.11, blender-mcp]并设env: {UV_PYTHON_PREFERENCE: only-managed}WSL / 远程部署连不上配置BLENDER_HOST、BLENDER_PORT环境变量确保 Blender 监听在服务器可达的地址都处理完还不行就按顺序重启 MCP 客户端和 Blender 里的服务器。进阶隐私开关与远程部署两个容易被忽略的设置遥测BlenderMCP 默认只发送匿名使用统计工具名、成功/失败、耗时、版本平台。想彻底关掉在客户端配置里加env: {BLENDER_MCP_DISABLE_TELEMETRY: true}或在插件偏好里取消勾选。提示词、代码、截图等详细字段只在勾选隐私开关后才会上传且凭证类字符串上传前会被剥离。远程主机服务器可以指向另一台机器上的 Blender设置BLENDER_HOST和BLENDER_PORT默认 9876即可截图以 base64 回传不需要共享临时目录。完整的功能表、各客户端配置和版本更新记录见 README.md安全与遥测的细节可以对照 SECURITY.md 查看。【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
