AI导哈

Blender MCP 控制服务

Blender MCP是一个通过自然语言控制Blender 3D的工具，支持从兼容MCP的IDE创建对象、运行Python脚本和查询场景数据。

  • by ailinking
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 ailinking/blender-mcp

使用说明

搅拌机MCP

Blender的模型上下文协议（MCP）服务器。

此项目允许您从任何兼容MCP的IDE（如Trae、Cursor、Claude Desktop等）控制Blender 3D。您可以使用自然语言创建对象、运行Python脚本和查询场景数据。

特性

  • 自然语言3D创作：让你的人工智能助手“创建一个红色立方体”或“生成一个程序城市”。
  • 完整的Python API访问：AI可以执行任何有效的 bpy 脚本。
  • 通用兼容性：通过简单的TCP网桥与任何MCP客户端配合使用。

建筑

  1. Blender服务器(blender_server.py)：Blender中运行的脚本，用于监听TCP连接并执行命令。
  2. MCP连接器(connector.py)：在IDE中运行的Python脚本，将标准输入/输出（Stdio）MCP消息转换为TCP，与Blender通信。

依赖项

Blender服务器需要 mcp Python包将在Blender的Python环境中提供。 在Windows上， pywin32 也被推荐。

我们提供自动化脚本来为您处理此问题。

安装和设置

1.安装依赖项

您可以将所需的库直接安装到本地 libs 文件夹，因此您不需要修改Blender的系统文件。

Windows用户：

  1. 跑 setup_dependencies.bat.
  2. 检查 install_log.txt 以确认成功。

手动安装（Mac/Linux/Windows）： 打开终端或命令提示符并运行：

# Replace 'blender' with the path to your Blender executable
blender -b --python install_dependencies.py

2.配置搅拌机

  1. 打开Blender（建议使用3.0+版本）。
  2. 切换到 脚本编写 选项卡。
  3. 打开 blender_server.py 在文本编辑器中。
  4. 点击 运行脚本 （播放按钮）。
  5. 打开 窗口>切换系统控制台 查看日志。您应该看到： Blender MCP Server listening on localhost:8123.

3.配置IDE

您需要告诉IDE运行 connector.py 脚本作为MCP服务器。

用于Trae/VS代码（通用MCP）

将其添加到您的MCP配置中（例如。， mcp.json):

{
  "mcpServers": {
    "blender": {
      "command": "python",
      "args": [
        "/absolute/path/to/blender-mcp/connector.py"
      ]
    }
  }
}

注意：确保使用绝对路径 connector.py.

用法

连接后，您可以询问您的AI助手：

  • “使用细分曲面创建猴头。”
  • “列出场景中的所有对象。”
  • 将相机移动到（0，-5，2）
  • “用随机颜色创建100个立方体的网格。”

安全说明

此工具允许通过本地TCP端口在Blender中远程执行Python代码。

  • 仅在本地计算机上运行此程序。
  • 请勿将端口8123暴露于互联网。

许可证

MIT许可证。看 许可证 文件以获取详细信息。

相关 MCP