mcp-for-blender

用嘴指挥 Blender 建模，说句话就改场景

mcp-for-blender 是一个 Blender 社区插件，通过 Model Context Protocol（MCP）把 Blender 3D 软件与大语言模型连接起来。它解决的核心问题是：让用户用自然语言指令驱动 Blender 完成建模、场景搭建和对象操作，而不用手写 Python 脚本或逐项点击菜单。插件在 Blender 内启动一个 MCP 服务端，把场景查询、对象创建、材质修改、变换操作等能力暴露成工具接口，任何支持 MCP 的 LLM 客户端（如 Claude 等）都能调用。用户只需描述需求，模型即可读取当前场景状态并执行对应操作，实现对话式 3D 创作。项目用 Python 编写，以 Blender 插件形式安装，兼容任意 LLM，不绑定单一厂商，适合希望用 AI 加速 3D 工作流的建模师、开发者和创意工作者。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 29335

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队ahujasid

所属国家

官网地址https://www.mcp-for-blender.com

GitHubhttps://github.com/ahujasid/mcp-for-blender

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型3d-modeling,ai,blender,blender-addon,blender-mcp,claude,generative-ai,llm,mcp,model-context-protocol,python

GitHub 星标★ 29335

30天Star增速

HF 下载量

上线时间2025-03-07 00:00:00

最近更新2026-09-25 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-26

浏览次数0

使用教程

难度：进阶约 10 分钟部署方式：本地安装 7 步

环境要求

已安装 Blender 3D（插件需在 Blender 内启用）
已安装 uv，或改用 pipx 安装
一个支持 MCP 的 LLM 客户端（如 Claude）
可选：Docker，用于以容器方式运行 MCP 服务端

安装与启动步骤

1安装 uv

README 的 Quickstart 第一步是安装 uv，但节选中具体安装命令被截断，请按 uv 官方说明安装后再继续。
2安装 MCP 服务端

锁定环境无法使用 uvx 时，用 pipx 安装 mcp-for-blender，并确保 PATH 生效后重启终端或客户端。
```
pipx install mcp-for-blender
pipx ensurepath
```
3配置 MCP 客户端

pipx 方式把 which 得到的 mcp-for-blender 绝对路径填到客户端 command，并省略 args。
```
which mcp-for-blender
```
4Docker 方式运行

不想本地安装时，从仓库根目录构建镜像，容器只跑 MCP 服务端，Blender 仍在本机运行。
```
docker build -t mcp-for-blender .
```
5安装 Blender 插件

把插件复制到 Blender 插件目录并命名为 blender_mcp.py，命令会打印写入路径并备份被替换的文件。
```
uvx mcp-for-blender install-addon
```
6启用插件

在 Blender 打开 Edit → Preferences → Add-ons，搜索并启用 MCP for Blender；未出现可 Install… 选文件或重启。
7启动 MCP 服务器

在 3D 视图按 N 打开侧边栏，切到 MCP for Blender 标签页，点击 Start MCP Server 建立连接。

关键配置

配置项	必填	说明	示例
`command`	是	MCP 客户端里要执行的命令，Docker 方式填 docker，pipx 方式填绝对路径	`docker`
`args`	是	Docker 方式必须包含 -i，服务端通过 stdin/stdout 与客户端通信	`["run", "-i", "--rm", "mcp-for-blender"]`
`BLENDER_HOST`	否	容器连接 Blender 的主机地址，镜像默认 host.docker.internal	`localhost`
`BLENDER_MCP_SAFE_MODE`	否	设为 1 在容器中启用安全模式	`1`
`BLENDERMCP_ADDONS_DIR`	否	覆盖插件安装的目标插件目录	`/path/to/scripts/addons`

如何确认成功

在 Blender 侧边栏点击 Start MCP Server 完成连接，MCP 客户端能正常读取场景并调用 Blender 工具即为可用。

常见问题

Q：以前叫 blender-mcp，需要改配置吗？

A：不需要。uvx blender-mcp 仍能运行服务端，现有配置无需改动；新安装请使用 mcp-for-blender。

Q：Linux 上 Docker 方式连不上 Blender 怎么办？

A：Linux 没有 host.docker.internal，且插件只监听 localhost，请改用 --network=host 并把 BLENDER_HOST 设为 localhost。

Q：插件列表里找不到 MCP for Blender？

A：点击 Install… 选择复制出来的 blender_mcp.py / addon.py，或重启 Blender 后再搜索启用。

Q：install-addon 找不到 Blender 安装目录怎么办？

A：可手动下载仓库里的 addon.py，在 Blender 的 Add-ons → Install… 中选择安装；或用 BLENDERMCP_ADDONS_DIR 指定目录。

注意事项

这是第三方集成，并非 Blender 官方出品。
Docker 容器只承载 MCP 服务端，Blender 必须仍在本机运行。
Docker 配置中的 -i 参数必需，缺少会导致无法与客户端通信。
README 未给出 uv 的具体安装命令，需另行参考 uv 官方文档。

核心亮点

以 Blender 插件形式运行，直接读取和操作当前场景，无需导出模型或切换软件
基于 MCP 标准协议，兼容任意支持 MCP 的 LLM 客户端，不锁定单一模型厂商
把建模、变换、材质等操作封装成工具接口，LLM 可自主调用完成多步任务

不足之处

复杂建模任务依赖 LLM 的推理与工具调用能力，指令模糊时容易生成错误操作
插件能力受限于已暴露的 MCP 工具集，Blender 高级功能覆盖可能不完整

适用场景

用自然语言快速搭建基础场景和占位模型，加速前期概念探索
让 AI 批量修改场景中对象的材质、位置和命名，减少重复手工操作
在对话中查询当前 Blender 场景结构，辅助排查和整理复杂工程

替代项目

BlenderMCP、blender-mcp

项目介绍

mcp-for-blender 是智能体领域的开源项目，由 ahujasid 开发，2025 年首次发布。

在全站 13,109 个收录项目中，它的 GitHub 星标数（29,335）位列前 2%，在智能体分类的 2,520 个项目里位列前 3%。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-25。

它主要面向的使用场景是：用自然语言快速搭建基础场景和占位模型，加速前期概念探索。同类可对比的替代方案包括 BlenderMCP、blender-mcp。

上一篇：pfsense-mcp-server

下一篇：没有了！