项目简介

Blender MCP 服务器是一个 Blender 插件，它实现了 Model Context Protocol (MCP)，使得 Blender 可以作为一个后端服务，向支持 MCP 的客户端（如 AI 大模型应用）提供 3D 建模和操作能力。通过这个服务器，AI 可以理解并执行在 Blender 中的复杂任务。仓库同时包含了用于连接 MCP 服务器的 Python 客户端库 'mcp-use' 及示例应用代码。

主要功能点

将 Blender 核心功能（如创建、编辑对象，执行 Python 脚本）封装为 AI 可调用的工具。
支持获取 Blender 场景信息和对象属性。
集成第三方服务（如 PolyHaven、Hyper3D）的资产访问和生成能力。
通过标准协议（本项目插件实现了 TCP Socket 服务器，并通过包装命令支持标准 I/O 连接）与 AI 客户端通信。

安装步骤

确保已安装 Blender 3.0+ 和 Python 3.8+。
将本项目仓库克隆到本地。
在 Blender 中，通过 'Edit > Preferences > Add-ons' 安装本仓库中的 'addon.py' 文件作为插件，并启用。
根据仓库中 'backend/app.py' 等文件推断的依赖，在仓库根目录下（或包含 'backend' 目录的父级目录）安装 Python 依赖，例如运行 'pip install -r requirements.txt'（如果存在）或手动安装 'Flask', 'requests', 'mcp-use', 'langchain' 等库。
在 Blender 的 3D Viewport 侧边栏（按 N 键显示）找到 "BlenderMCP" 标签，点击 "Connect to Claude" (或类似按钮) 启动 MCP 服务器。

服务器配置 (供 MCP 客户端参考)

AI 客户端（例如使用 'mcp-use' 库的 Agent）连接到 Blender MCP 服务器时，需要指定连接方式。在本项目的示例中，客户端通过执行一个命令来启动并连接到 Blender MCP 服务器。客户端的配置示例如下（请注意，实际的服务器启动命令和参数可能因您的环境和安装方式而异，以下是根据示例代码推断的配置）：

{
  "mcpServers": {
    "blender": {
      "command": "uvx", // 用于执行Blender MCP入口点的命令，可能需要确保uvx工具已安装且在PATH中
      "args": ["blender-mcp"] // 传递给命令的参数，指向Blender MCP的特定启动方式
    }
  }
}

客户端通常会根据此配置通过标准输入输出与服务器进程进行 JSON-RPC 通信。

基本使用方法

按照安装步骤启动 Blender MCP 服务器插件并在 Blender 中运行服务器。
编写或运行一个使用 MCP 客户端库 (如 'mcp-use') 的 Python 程序。
在 Python 程序中，使用上述服务器配置信息创建一个 MCP 客户端实例，并建立与 Blender MCP 服务器的会话。
通过客户端调用 Blender MCP 服务器暴露的工具（例如 'execute_blender_code'），或者让 AI Agent 使用这些工具根据自然语言指令在 Blender 中创建或修改 3D 模型。示例代码可以在仓库的 'examples' 或 'backend' 目录下找到。

关键词

信息