这个项目能做什么

MCP for Blender 是一个社区构建的插件，通过模型上下文协议（MCP）将 Blender 3D 连接到任何 LLM（如 Claude、Codex 或 Cursor）。它允许你使用自然语言提示创建、修改和操作 3D 场景。 主要功能 - 双向通信：通过基于 socket 的服务器将 AI 助手连接到 Blender - 对象操作：创建、修改和删除 3D 对象 - 材质控制：应用和修改材质与颜色 - 代码执行：从 AI 在 Blender 中运行任意 Python 代码 - 资产与模型生成：从 Poly Haven、Sketchfab、Poly Pizza 导入，以及通过 Hyper3D Rodin 和 Hunyuan3D 生成 AI 模型 工作原理 插件由两个主要部分组成： 1. MCP 服务器（src/blender_mcp/server.py）——实现模型上下文协议的 Python 服务器 2. Blender 插件——Blender 3D 视口中的侧边栏面板，用于启动连接 设置 1. 使用官方安装程序安装 uv（Python 包管理器） 2. 安装 Blender 插件（可通过命令行或手动通过 Blender 的首选项安装） 3. 配置你的 MCP 客户端（Claude Desktop、Claude Code、Codex、Cursor、VS Code 等） 4. 在 Blender 中，按 N 打开侧边栏，找到 MCP for Blender 选项卡，然后点击 Start MCP Server 能力 - 在 Blender 中执行任意 Python 代码 - 从 Poly Haven 下载模型、资产和 HDRI - 从 Sketchfab 搜索和下载模型 - 从 Poly Pizza 搜索和下载低多边形模型 - 通过 Hyper3D Rodin 和 Hunyuan3D（腾讯云）生成 3D 模型 示例命令 - “创建一个低多边形场景，在一个地牢中，有龙守护着一罐金子” - “给出一张参考图片，并从中创建一个 Blender 场景” - “通过 Hyper3D 生成一个花园地精的 3D 模型” - “用 Poly Pizza 的低多边形家具填满这个房间” 配置 环境变量允许自定义： - BLENDER_HOST（默认：localhost） - BLENDER_PORT（默认：9876） - BLENDER_MCP_SAFE_MODE——设置为 1 以在运行前验证脚本 安全注意事项 - 插件套接字服务器没有身份验证或加密 - 默认情况下，AI 可以在 Blender 中运行任意 Python 代码 - 安全模式（BLENDER_MCP_SAFE_MODE=1）会阻止文件 I/O、网络访问或持久化代码安装等危险操作 持久化 API 凭据 将 Sketchfab、Poly Pizza、Hyper3D 和 Hunyuan3D 的 API 密钥存储在 Blender 的首选项中，或通过环境变量存储，以用于无头/CI 环境。 Docker 支持 MCP 服务器可以在容器中运行，而无需在本地安装。Blender 仍在你的机器上运行；容器仅托管 MCP 服务器并向外连接到 Blender 插件。 免责声明 这是一个第三方集成，并非由 Blender 制作。