跳到主要内容
Stable3D & Animation

MCP for Blender — Connect AI Agents to Blender

给 Agent 一个真实的 Blender 会话，而不是一个空白的 Python 提示框。每次调用都经过类型校验、对照当前场景验证，并写入审计日志。

Install Blender integrationComing soon
Read-only by default8 typed toolsCheckpointed writes
Technical specification
宿主软件
Blender 4.2 LTS and newer (4.5, 5.x)
运行时
Python 3.11+, bundled with Blender
传输方式
stdio (local) and streamable HTTP (remote studio)
安装方式
Blender addon + npx dccmcp-blender
运行模式
Interactive viewport, background/headless, batch farm workers
支持平台
macOS, Windows, Linux
Last reviewed
2026-09-20
概述

什么是 MCP for Blender？

MCP for Blender is a local MCP server plus a Blender plugin that connects AI agents to a real Blender session. Agents discover 8 typed tools — including scene.inspect, object.create, mesh.edit and geometry_nodes.set_input — and call them to inspect, create, modify and validate work inside the live application.

Unlike generated Blender scripts, every call is validated against your current document, classified as read, write or execute, and recorded in an audit log. Blender stays open, the document stays live, and destructive operations are checkpointed so they can be rolled back.

It works with Claude Code, Codex, Cursor, GitHub Copilot, Claude Desktop, Gemini CLI, Trae, Doubao, Qwen Code, CodeBuddy, Custom MCP clients, Windsurf over stdio or streamable HTTP.

  • 宿主软件: Blender 4.2 LTS and newer (4.5, 5.x)
  • 运行时: Python 3.11+, bundled with Blender
  • 传输方式: stdio (local) and streamable HTTP (remote studio)
为什么会失败

没有契约时，让 Agent 驱动 Blender 会出什么问题

01

生成的脚本假设了一个并不存在的场景

写 bpy 代码的模型从没见过你的文件。它靠猜集合名、对象路径和修改器栈，跑到一半失败，留下一个改坏了一半的场景。

02

一次崩溃赔掉一小时的工作

在没有检查点的情况下调用破坏性操作，可能损坏场景、破坏链接库，甚至把视口一起拖垮。

03

没人能复核模型到底做了什么

无人值守的自动化如果没记录——改了哪个对象、谁改的、什么时候——工作室就无法签核。

如何工作

MCP for Blender 如何保住设计意图、结构与可追溯性

一个本地 MCP Server 加一个 Blender 插件，为 Agent 提供类型化、可审计的工具：场景检查、建模、几何节点、材质、渲染与无界面批处理。

先读取，再动手

Agent 先调用 scene.inspect，拿到集合、对象、修改器、材质与单位制的结构化摘要，然后才提出改动方案。

类型化工具，而不是自由发挥的 bpy

工具接收经过校验的 schema——网格名、带单位的尺寸、插槽索引。非法调用在边界就被拒绝，而不是在渲染到一半时出错。

带检查点的写操作

每个修改型工具都运行在可预览、可应用、可回滚的事务里，Blender 自身的撤销历史也保持完整，方便人工收拾。

批处理与无界面一致

同一套工具面也能驱动后台模式下的 Blender，Agent 可以在渲染农场上按完全一致的语义批量生成变体。

工具参考

MCP for Blender 工具清单与风险等级

Agent 在连接时就能发现这份清单。你可以决定哪些自动放行、哪些需要人工确认、哪些在生产文件中直接禁用。

工具名与参数签名保持英文——它们是 Agent 实际调用的接口。

  • scene.inspectStructured snapshot of collections, objects, transforms, modifiers, materials and units.read
  • object.createCreate primitive or data-driven objects with validated transforms and parenting.write
  • mesh.editNon-destructive mesh operations with explicit selection scoping and dry-run preview.write
  • geometry_nodes.set_inputDrive geometry node inputs by socket name and type, including simulation zones.write
  • material.assignAssign or build shader graphs, including principled BSDF parameter sets.write
  • render.captureQueue viewport or final renders and return rendered images for verification.execute
  • pipeline.checkpointCreate, list and restore named checkpoints of the current file state.write
  • asset.searchSearch local asset libraries and return typed asset references.read
安装

四步安装 MCP for Blender

全部本地运行。服务默认只绑定回环地址，且只暴露你在 Blender 中批准的工具。

预发布。 以下命令描述的是我们即将发布的接口，软件包尚未发布。 Get notified when MCP for Blender launches.

STEP 01

安装插件

把 DCCMCP 插件装进 Blender，在「偏好设置 → 插件」里启用。插件只开一个本地控制通道，默认不会监听任何公网接口。

blender --command extension install dccmcp_blender
STEP 02

启动 MCP Server

在项目目录下启动服务，它会自动发现正在运行的 Blender 会话，并把工具清单广播给客户端。

npx dccmcp-blender@latest serve --port 7331
STEP 03

注册到你的 Agent

把服务写进 MCP 客户端配置。Claude Code、Codex、Cursor、OpenClaw、VS Code 或任何兼容 MCP 的客户端，走的是同一套 stdio 或 HTTP 传输。

{
  "mcpServers": {
    "blender": { "command": "npx", "args": ["dccmcp-blender", "serve"] }
  }
}
STEP 04

设置策略

决定哪些工具自动放行、哪些需要人工确认、哪些在生产文件里直接禁用。默认是只读。

dccmcp policy set --profile studio-default

MCP for Blender works with the agents you already use

  • Claude Code
  • Codex
  • Cursor
  • GitHub Copilot
  • Claude Desktop
  • Gemini CLI
  • Trae
  • Doubao
  • Qwen Code
  • CodeBuddy
  • Custom MCP clients
  • Windsurf

Any other MCP-compatible client works too — one config entry, stdio by default.

Read the docs
其他集成

常与 Blender 搭配使用的其他 MCP 集成

MCP for Maya

Connect AI agents to Maya — scene assembly, rigging, animation curves and batch rendering.

查看集成

MCP for 3ds Max

Archviz and animation automation for agents — modifiers, materials, XRefs and batch export.

查看集成

MCP for Rhino

Drive Rhino and Grasshopper from an AI agent — NURBS, layers, blocks and parametric definitions.

查看集成

10 integrations available

Compare tool lists, support matrices and policies for every supported application.

Browse all integrations
常见问题

团队在安装前最常问的问题

如果没有覆盖到你的问题，直接写信给我们——技术问题我们给技术回答。

  • 不会。服务运行在你自己的机器上，只和本地的 Blender 进程通信。只有当你显式为工作室部署配置了远程 HTTP 传输时，场景数据才可能离开你的网络——即便如此，也只传输 Agent 主动请求的工具结果。

  • 修改型工具受策略层管控，默认配置是只读。所有方案都可以撤销最近一次运行，一次错误调用只需一次点击就能退回。Studio 与企业版保留的是完整版本历史而非仅仅上一步：可以对比任意两次运行、标记某个好版本、并在之后随时恢复——当场景要经过很多轮修改时，这一点才真正重要。

  • 支持。同一套工具面在 -b/--background 会话里同样可用，工作室的变体生成与渲染农场就是这么驱动的。

  • Blender 4.2 LTS 及更新版本，含 4.5 LTS 与 5.x。旧版 3.x 支持放在企业版通道。

  • 生成的脚本没有校验、无法单独运行、也无法复核。DCCMCP 提供的是一套稳定、可发现、带 schema、带权限和审计的工具面——Agent 是在契约上工作，而不是在猜测上工作。

npx dccmcp-blender@latest serve

Put an agent inside your real tools — without putting your pipeline at risk

Install an integration, set a policy, and let your agent inspect, build and validate work in Blender, Maya, Houdini, 3ds Max, Rhino, ZBrush, Photoshop, FreeCAD, QGIS or OpenCV. Free to start, local by default.

Coming soonRead the quickstart

macOS · Windows · Linux — no cloud dependency required