关键词

AI智能体控制BlenderUnreal Engine3D内容创作自动化

使用说明

项目简介

Unreal & Blender 统一MCP服务器是一个基于Model Context Protocol (MCP) 构建的后端服务，它扩展了blender-mcp框架，并加入了对Unreal Engine的支持。此服务器允许AI智能体（如Claude、ChatGPT等）通过单一接口同时控制Blender和Unreal Engine，实现跨平台的工作流程和协同操作，为3D内容创作提供强大的自动化能力。

主要功能点

  • 统一控制: 通过单一MCP服务器统一管理和控制Blender和Unreal Engine。
  • AI智能体集成: 专为与Claude、ChatGPT等AI智能体协同工作设计。
  • Blender 功能: 保留blender-mcp的所有功能，包括场景操作、物体创建编辑、材质管理、PolyHaven资源集成、Hyper3D Rodin模型生成等。
  • Unreal Engine 功能: 支持关卡创建管理、资源导入、Python代码执行、场景操作等。
  • 扩展性架构: 采用扩展结构，易于扩展Blender插件和服务器功能，同时保持与上游更新的兼容性。

安装步骤

  1. 克隆仓库: 使用以下命令克隆仓库，包含子模块： 
    git clone --recursive https://github.com/tahooki/unreal-blender-mcp.git
cd unreal-blender-mcp
  2. 设置Python环境: 
    uv venv
# 激活虚拟环境
# Windows:
.\venv\Scripts\activate
# macOS/Linux:
source venv/bin/activate
# 安装依赖
uv pip install -e .
  3. 安装Blender插件:
    • 标准插件: 在Blender中，编辑 -> 偏好设置 -> 插件 -> 安装，选择 'blender-mcp/addon.py' 文件并启用 "Interface: Blender MCP" 插件。
    • 扩展插件: 运行命令 'python -c "from src.unreal_blender_mcp.blender_addon import BlenderAddonManager; BlenderAddonManager().install_to_blender(force=True)"'，然后在Blender中启用 "Interface: Extended Blender MCP" 插件。
  4. 安装Unreal Engine插件:
    • 将 'UEPythonServer' 文件夹复制到Unreal项目 'Plugins' 目录下（没有则创建）。
    • 在Unreal Engine编辑器中，编辑 -> 插件，启用 "Python Server" 插件并重启Unreal Engine。
  5. 启动MCP服务器:
    • 标准服务器: 运行 'python main.py'。
    • 扩展服务器: 运行 'python run_extended_server.py'，可使用 '--host', '--port', '--log-level' 等参数自定义服务器配置。
  6. 启用Blender服务器连接: 启动Blender，在3D视图侧边栏 (N 键)，选择 "BlenderMCP" 或 "ExtBlenderMCP" 选项卡，点击 "Start Server" 按钮。
  7. 验证Unreal Engine连接: 启动Unreal Engine，并确保插件已启用，Unreal Engine插件的Python服务器应自动启动，可在输出日志中查看状态。

服务器配置

以下为配置MCP客户端（如Claude for Desktop, Cursor等）连接到Unreal & Blender 统一MCP服务器的示例配置 (JSON 格式)。您需要将以下配置添加到您的MCP客户端的配置文件中。

Claude for Desktop 配置示例:

{
    "mcpServers": {
        "unreal-blender": {
            "command": "uvx",
            "args": [
                "unreal-blender-mcp"
            ]
        },
        "unreal-blender-ext": {
            "command": "python",
            "args": [
                "/path/to/unreal-blender-mcp/run_extended_server.py"
            ]
        }
    }
}
  • 'unreal-blender': 标准服务器配置名称，可自定义。
    • 'command': 'uvx' - 使用 'uvx' 命令启动标准服务器 (假设已安装 'uv' 并配置好虚拟环境)。
    • 'args': '["unreal-blender-mcp"]' - 传递给 'uvx' 命令的参数，指定运行 'unreal-blender-mcp' 包。
  • 'unreal-blender-ext': 扩展服务器配置名称，可自定义。
    • 'command': 'python' - 使用 Python 解释器启动。
    • 'args': '["/path/to/unreal-blender-mcp/run_extended_server.py"]' - 指向扩展服务器启动脚本的路径。请将 '/path/to/' 替换为您的实际项目路径。

Cursor 配置示例: 在Cursor的MCP设置中添加以下命令：

  • 标准服务器: 'uvx unreal-blender-mcp'
  • 扩展服务器: 'python /path/to/unreal-blender-mcp/run_extended_server.py' 同样，请将 '/path/to/' 替换为您的实际项目路径。

基本使用方法

配置完成后，在您的AI客户端中选择对应的MCP服务器配置，即可通过自然语言指令控制Blender和Unreal Engine。例如，您可以指示AI智能体在Blender中创建模型、修改材质，或在Unreal Engine中创建关卡、导入资源等，实现跨平台协同工作流程。

信息

分类

桌面与硬件

访问项目