Blender MCP + Claude —— 完整配置与使用指南

Blender MCP 通过 Model Context Protocol(MCP) 把 Blender 和 Claude 连接起来,让 Claude 能够直接用自然语言在 Blender 里创建、修改和渲染 3D 模型。本指南涵盖让 Claude 和 Blender 协同工作所需的全部内容——从最初的安装,到进阶的提示词技巧。

无论你用的是 Claude Desktop、Claude Code 还是 Anthropic API,这篇都适用。整个配置大约需要 5–10 分钟,而且不花钱——Blender MCP 是免费开源的。

前置条件

开始之前,请确认你已经有:

Blender 3.0 或更新的版本 —— 从 blender.org 下载。推荐 Blender 4.x。
Python 3.10 或更新的版本 —— 一般系统自带。用 python3 --version 检查。
Claude 桌面应用 —— 从 claude.com 下载 (也可以用 Claude Code 命令行)。
一个 Anthropic 账号 —— 免费额度可用,但处理复杂场景时 Pro 的效果更好。

继续之前必须先安装 uv 包管理器。没有它,MCP 服务端无法运行。

第 1 步:安装 uv 包管理器

Blender MCP 服务端通过 uvx(uv 工具链的一部分)运行。按你的平台安装:

macOS


brew install uv

验证安装:


uv --version

Windows

打开 PowerShell 并运行:


powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

然后把 uv 加入 PATH(之后可能需要重启 Claude Desktop):


$localBin = "$env:USERPROFILE\.local\bin"
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$userPath;$localBin", "User")

Linux


curl -LsSf https://astral.sh/uv/install.sh | sh

uv 的完整安装文档(英文):docs.astral.sh/uv/getting-started/installation

第 2 步:配置 Claude Desktop(claude_desktop_config.json)

打开 Claude Desktop,进入 Settings → Developer → Edit Config,它会打开你的 claude_desktop_config.json 文件。加入 Blender MCP 服务端:


{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": ["blender-mcp"]
    }
  }
}

保存文件,然后重启 Claude Desktop 让改动生效。

配置文件在哪里?

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

改用 Claude Code

如果你更习惯 Claude Code 命令行,一条命令就能加上 MCP 服务端:


claude mcp add blender uvx blender-mcp

不需要手动编辑配置文件——Claude Code 会自动处理。

第 3 步:安装 Blender 插件

这个 Blender 插件会在 Blender 内部启动一个 socket 服务,用来接收来自 Claude 的指令。

下载插件

从 Blender MCP 的 GitHub 仓库下载 addon.py。

在 Blender 中安装

打开 Blender → Edit → Preferences → Add-ons → 点击 “Install…” → 选择刚下载的 addon.py 文件。

启用插件

勾选 “Interface: Blender MCP” 前面的复选框,把它启用。

第 4 步:启动 MCP 服务端

插件装好之后,还需要把连接建立起来:

打开 BlenderMCP 面板

在 Blender 的 3D 视图里按 N 打开侧栏,然后找到 “BlenderMCP” 标签页。

启用 Poly Haven(可选)

如果你想使用 polyhaven.com 上免费的 HDRI、贴图和 3D 模型,把 Poly Haven 的复选框打开。

点击 “Connect to Claude”

这一步会启动 Blender 内部的 socket 服务。你应该会看到一条确认连接成功的状态提示。

同一时间只运行一个 MCP 服务端实例。 如果你在 Cursor 和 Claude Desktop 里同时跑着 MCP 服务端,连接会互相冲突。只选一个。

第 5 步:用 Claude 做出第一个 3D 模型

打开 Claude Desktop(或 Claude Code)。你应该能看到一个锤子图标,表示 MCP 工具已经可用。试试这些提示词:

“做一个低多边形的地牢场景,里面有一条守着一罐金币的龙”
“用 Poly Haven 的 HDRI 和模型做出海滩的氛围”
“做一个悬在蓝色立方体上方的红色金属球”
“布置影棚灯光,并把相机对准场景,用等距视角”
“通过 Hyper3D 生成一个花园地精的 3D 模型”

Claude 可以创建物体、设置材质、布置灯光、下载 Poly Haven 素材、通过 Hyper3D Rodin 生成 3D 模型,甚至在 Blender 里执行任意 Python 代码。

小技巧: 从简单的请求开始,再逐步增加复杂度。比起逐条描述操作步骤,描述你想要的最终结果,Claude 的表现更好。复杂场景一次做不成的话,就拆成几个小的提示词。

常见问题排查

”Connection refused” 或 “MCP server not found”

确认 Blender 插件那边的服务已经在运行(看 BlenderMCP 侧栏面板)
改完配置文件后重启 Claude Desktop
确认 uv 已安装:uv --version
不要自己在终端里手动运行 uvx blender-mcp —— 这件事由 Claude Desktop 负责

”Timeout” 超时错误

复杂的操作可能比预期更久。试着把请求写简单一些。
把大场景拆成几个小的、按顺序执行的提示词。

第一条指令没反应

这是一个已知的小毛病。连接之后的第一条指令有时候发不出去。再发一条,通常就正常了。

Poly Haven 素材加载不出来

Claude 在 Poly Haven 集成上的表现不太稳定。如果不奏效,把需求写得更具体一些(例如:“从 Poly Haven 下载一张森林 HDRI,并把它设为世界背景”)。

Windows 上的 PATH 问题

如果 Claude 找不到 uvx,请确认 uv 的 bin 目录已经在系统 PATH 里。修改过 PATH 之后要重启 Claude Desktop。

Claude Desktop、Claude Code 和 API —— 该用哪个

方式	适合谁	配置难度
Claude Desktop	视觉创作者、新手	最简单——图形界面配置
Claude Code	开发者、习惯用终端的人	简单——一条命令行
Anthropic API	自定义集成、自动化	进阶——需要写代码

对大多数人来说,Claude Desktop 是推荐的起点。它提供可视化的对话界面,并且会自动管理 MCP 服务端的生命周期。

如果你本来就习惯用终端,想把 Blender MCP 和写代码的流程结合起来,Claude Code 更合适。

Anthropic API 给你完整的编程控制权,适合在 Blender MCP 之上搭建自动化的 3D 资产流水线或自定义工具。

效果不错的示例提示词

下面这些提示词来自 Blender MCP 社区的实际使用:

提示词	它会做什么
”做一个地牢里的低多边形场景,有一条龙守着一罐金币”	包含多个物体的完整场景构建
”用 Poly Haven 的 HDRI、贴图和模型做一个海滩”	用真实素材做环境设计
”给它一张参考图,据此搭出一个 Blender 场景”	基于参考图的场景创建
”通过 Hyper3D 生成一个花园地精的 3D 模型”	AI 生成 3D 模型
”读取当前场景的信息,并据此写一个 Three.js 页面”	把场景导出到网页
”把这辆车改成红色金属材质”	修改材质
”把相机对准场景,并改成等距视角”	相机与渲染设置

Blender MCP 是免费的吗?

是的。 Blender MCP 完全免费且开源(MIT 许可证 )。Blender 本身也是免费的。唯一的开销是你的 Claude 订阅——免费额度可以用,但在复杂的 3D 场景上,Claude Pro(每月 20 美元)的效果要好得多。

如果你更愿意自己部署模型,而不是为云端模型付费,可以看我们的 Ollama 本地部署指南。那是一条进阶路线:需要一块够用的 GPU,配置和维护的工作量大得多,而且在复杂的 Blender 任务上,效果通常不如领先的云端模型。

Blender MCP 是怎么工作的?

Blender MCP 由两个部分组成:

Blender 插件(addon.py)—— 在 Blender 内部启动一个 socket 服务,监听指令
MCP 服务端(server.py)—— 在 Claude 的 MCP 协议和 Blender 的 socket 服务之间做翻译

当你在 Claude 里发送一条消息时,MCP 服务端会接收它、转换成 Blender 指令、通过 socket 发给插件,再把结果返回。想看技术层面的详细解释,可以读我们的 MCP 服务端架构详解。

本页的文字步骤是完整的,不看视频也能配完。想对照着看的话,下面这段完整的安装演示录屏在 YouTube 上,只有英文、没有中文字幕;在你点开之前,本页不会加载它的任何内容。

在 YouTube 上观看(英文,能否访问取决于你自己的网络)

完整安装与演示

用的是别的 AI 客户端?

Cursor 配置 →VSCode 配置 →ChatGPT 配置 →Gemini 配置 →Ollama 配置 →

常见问题

可以免费把 Blender MCP 和 Claude 一起用吗?

可以。Blender MCP 免费且开源,Blender 也是免费的。你只需要一个 Claude 账号——免费额度足够做基础任务,但复杂场景下 Claude Pro(每月 20 美元)效果更好。Ollama 是进阶的替代方案:把模型部署在你自己的 GPU 上,而不是为云端模型付费,代价是配置和维护的工作量大得多,而且在复杂的 Blender 任务上效果通常更弱。

Blender MCP 和 Claude 是怎么配合的?

Blender MCP 通过 Model Context Protocol 把 Claude 连接到 Blender。Blender 插件启动一个 socket 服务,MCP 服务端在 Claude 和 Blender 之间充当桥梁。Claude 发出的自然语言指令会被翻译成 Blender 的操作——创建物体、设置材质、布置灯光等等。

Claude Desktop 支持 MCP 服务端吗?

支持。Claude Desktop 原生支持 MCP。进入 Settings → Developer → Edit Config 就可以添加 MCP 服务端。你也可以用 Claude Code 命令行,它通过 'claude mcp add' 命令支持 MCP。

哪些 AI 模型能配合 Blender MCP?

Blender MCP 最初是为 Claude 设计的,但同样可以配合 Cursor、VSCode(通过 Cline / Roo Code)、Google Gemini CLI,以及通过 Ollama 使用的本地模型。任何支持 Model Context Protocol 的 AI 客户端都能连上 Blender MCP。

怎么配置 Blender MCP?

安装 uv 包管理器,把 Blender MCP 服务端的配置写进 Claude Desktop 的配置文件(claude_desktop_config.json),从 GitHub 仓库下载并安装 Blender 插件,然后在 Blender 侧栏点击 'Connect to Claude'。整个过程大约 5–10 分钟。

Blender MCP 能做什么?

Blender MCP 可以创建、修改和删除 3D 物体;设置和修改材质;布置灯光和相机;从 Poly Haven 下载素材;通过 Hyper3D Rodin 生成 3D 模型;在 Blender 中执行任意 Python 代码;以及导出场景数据。它支持 Blender 3.0 及以上版本,并可搭配多种 AI 客户端。

配置还是不顺利?这正是开源那条路的代价 —— AI 客户端、模型和配置都要你自己选、自己维护。我们自己的付费应用 3D-Agent 则把 AI 和整套工具一并包含在内。对比 Blender MCP 与 3D-Agent →