ellmos Blender Use

Name: ellmos Blender Use
Author: ellmos-ai

本地服务

github.com媒体与设计24 周前更新

代码仓库访问官网

关于 ellmos Blender Use

ellmos Blender Use 是面向技术美术和资产流水线团队的本地优先 MCP 服务，可在无界面的 Blender 中检查 FBX 重导入和几何状况，并返回结构化结果，无需插件或常驻进程。

主要功能

01无界面 FBX 重导入检查
02网格、材质和名称验证
03四视图几何渲染
04受限的 Blender 脚本执行
05定位 Blender 可执行文件

适用场景

01在 CI 流水线中把关 FBX 资产
02检查命名前缀和材质分配
03发现旋转、悬浮部件和枢轴问题

MCP 相关

它通过 stdio 向 MCP 客户端提供 Blender 验证和执行工具。每次调用都会启动有时限的一次性无界面 Blender 进程。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "ellmos-ai-ellmos-blender-use": {
      "command": "npx",
      "args": [
        "-y",
        "ellmos-blender-use-mcp"
      ]
    }
  }
}

启动命令npx -y ellmos-blender-use-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmellmos-blender-use-mcp0.1.0-alpha.9stdio

工具

收录的工具列表 · 更新于 3 天前

参数	类型	必填	说明
blenderPath	string	否

详细介绍

ellmos Blender Use MCP

🇩🇪 德语版

隶属于 ellmos-ai 家族及 open-bricks 开源计划。

快速导航

语言 / 语言： 🇬🇧 英语 | 🇩🇪 德语

#	章节（英文）	章节（德文）	锚点
01	核心功能	核心功能	`#sec-01`
02	目标用户与可发现性	目标群体与可发现性	`#sec-02`
03	与替代方案的比较矩阵	与替代方案的比较矩阵	`#sec-03`
04	架构与组件拓扑	架构与组件拓扑	`#sec-04`
05	无头验证生命周期	无头验证生命周期	`#sec-05`
06	工具套件与验证矩阵	工具套件与验证矩阵	`#sec-06`
07	FBX 重新导入详解与架构	FBX 重新导入详解与架构	`#sec-07`
08	视觉验证详解与架构	视觉检查详解与四视图几何	`#sec-08`
09	通用基础工具	通用基础工具	`#sec-09`
10	CI/CD 流水线集成	CI/CD 流水线集成	`#sec-10`
11	治理与运行时不变量	治理与运行时不变量	`#sec-11`
12	安全策略与执行隔离	安全策略与进程隔离	`#sec-12`
13	安装与快速入门	安装与入门	`#sec-13`
14	配置与环境变量	配置与环境变量	`#sec-14`
15	第三方许可证与 Level 1 SBOM	第三方许可证与 Level 1 SBOM	`#sec-15`
16	ellmos-ai 生态系统与集成	同系列项目与 ellmos-ai 生态系统	`#sec-16`
17	大模型上下文索引与机器提示词	大模型上下文索引与机器提示词	`#sec-17`
18	许可证与法定免责声明（§ 521 BGB）	许可证与免责声明（§ 521 BGB）	`#sec-18`

1. 主要功能

面向游戏和 3D 资源管线的资源 QA 工具：在无头模式下验证导出的 FBX 能否在 Blender 中顺利重新导入——自动检查网格数量、材质数量和必需的命名前缀，并返回确定性的 JSON 结果，无需人工目测。blender_verify_fbx_reimport 是核心结构验证工具，blender_verify_visual 是它的视觉验证工具：前者统计网格并检查名称前缀，后者渲染四个视图并测量仅靠计数无法发现的几何问题。blender_locate 和 blender_run_script 是两者基于的通用基础工具。

无需插件。无需 TCP 端口。无需后台守护进程。 此服务不会向 Blender 安装任何内容，不会为正在运行的 Blender 实例打开套接字，也不会让 Blender 常驻。每次调用都会启动 blender --background --python <script.py>，等待进程在设定的超时限制内退出，然后返回结果——从设计上就是无头且无状态的。此服务不会下载资源，也不会收集遥测数据。

与其他 Blender MCP 服务的区别。 大多数 Blender MCP 项目（例如 ahujasid/blender-mcp 和官方的 Blender Labs MCP 服务）通过 TCP／插件桥接来控制正在运行的 Blender GUI，以便交互式编辑场景——这是另一种用途，信任模型也不同（开放套接字、已安装的插件、持久运行的进程）。而此服务面向的是 CI 风格的一次性资源验证：在管线步骤中运行，获取通过／失败的 JSON，然后继续后续流程。如果需要实时控制 GUI，请单独使用经过审查的 Blender MCP 插件（见下文的安全说明）。

说明

AI／大模型集成与机器可读上下文：AI 助手（Claude、Codex、Gemini）可以读取 llms.txt，获取机器可读的上下文、搜索短语和工具文档。回归测试套件可确保隐私规范和运行时内存安全。

提示

CI 与资源管线自动化：在将 3D 资源提交到源代码管理之前，使用 blender_verify_fbx_reimport 作为自动化关卡。它无需人工介入，即可标记缺失的前缀（例如 SM_、M_）、异常的网格数量或损坏的材质分配。

2. 目标用户与高意向搜索

[PERSONA-01] 独立游戏与 AAA 游戏技术美术师及 3D 管线 TD

简介： 管理 Unreal Engine、Unity、Godot 和自定义 C++ 游戏引擎的 FBX／GLTF 资源管线的技术美术师。
痛点： 导出的 3D 资源经常存在未应用的旋转（导入引擎后横倒）、枢轴偏移损坏、缺少 SM_／M_ 前缀或材质未分配等问题，人工审查容易漏过。
高意向搜索词： blender fbx reimport verification mcp、blender headless asset qa gate、automated fbx naming convention check、detect unapplied rotation fbx blender。
解决方案： 一次性完成结构重新导入验证和四视图几何检查，无需打开 Blender GUI。

[PERSONA-02] CI／CD 自动化与构建基础设施工程师

简介： 负责在 GitHub Actions、GitLab CI 或 Jenkins 中设置自动化资源验证关卡的 DevOps 和构建工程师。
痛点： 传统 Blender 自动化工具需要安装图形界面插件，或运行交互式后台套接字，因此无法在无头容器化运行器中正常工作。
高意向搜索词： headless blender asset qa mcp server、github actions blender fbx qa gate、blender background script ci cd verification、blender mcp no add-on no tcp port。
解决方案： 以无状态方式执行 blender --background，将失控超时严格限制为 15 分钟，将内存尾部限制为 8 KB，无需插件，并返回确定性的 JSON 退出代码。

[PERSONA-03] 自主 AI Agent 工程师（Claude、Codex、Gemini）

简介： 部署自主 AI 编码 Agent，用于程序化 3D 生成、资产处理和游戏原型开发的开发者。
痛点： AI Agent 需要检查和验证 3D 资产，同时避免套接字泄漏、僵尸进程或不受控制的内存消耗。
高意向查询： mcp server fbx mesh material verification、ai agent blender 3d asset inspection、blender four-view rendering mcp、llm tool headless blender。
我们的解决方案： 原生 Model Context Protocol（MCP）服务，提供全面的 llms.txt 文档、可靠的 taskkill /T /F 进程树终止机制，以及失败时默认关闭的临时文件清理机制。

[PERSONA-04] 企业游戏工作室合规与安全官

简介： 保护专有游戏 IP 和开发工作站的安全官与合规经理。
痛点： 第三方 DCC 工具经常打开本地网络端口、拨号连接远程遥测服务，或要求管理员权限。
高意向查询： offline blender mcp zero egress、air gapped 3d asset verification、unprivileged blender asset qa、zero copyleft mcp tool。
我们的解决方案： 严格通过 RunAsInvoker 非提权认证，保证 100% 离线且零出站流量，运行时零遥测，并提供无 Copyleft 许可证的 Level 1 SBOM。

3. 与替代方案的 10 维对比矩阵

不变量 / 维度	[1] `ellmos-blender-use-mcp`	[2] Interactive Blender MCP（TCP 插件）	[3] 临时 Python 脚本	[4] 大型 DCC 套件（Maya / 3ds Max QA）	[5] 云端 SaaS 3D 检查工具（Sketchfab）
INV-LOCAL-01：网络与物理隔离	100% 离线 / 零外传（0 次网络调用）	需要开启 TCP localhost 监听器	本地运行，但网络访问不受限制	本地运行，但会频繁轮询许可证服务器	需要上传到远程 SaaS（存在数据外传风险）
INV-HEADLESS-02：插件负担	无需任何插件（开箱即用）	需要安装 Blender 插件	无需安装插件	需要安装专有插件	通过 Web 浏览器或大型客户端上传
INV-SEC-03：权限模型	以非特权 RunAsInvoker 运行（用户模式）	用户模式，但开放套接字扩大了攻击面	脚本可不受限制地执行	需要以管理员身份安装 / 安装为服务	SaaS 云安全边界
INV-BOUND-04：内存边界	硬性尾部缓冲区（最大 8 KB - 50 KB）	GUI 会话内存不受限制	控制台输出内存不受限制	工作站内存占用不受限制	云处理配额
INV-INTEG-05：结构化 JSON QA	确定性的机器可读 JSON	文本提示词 / 聊天回复	非结构化 stdout 输出	XML / 专有日志报告	Web 仪表板可视化
INV-VISUAL-06：四视图几何检查	标准化的四视图渲染工作流	手动在 GUI 中旋转查看	需要自定义相机脚本	手动浏览视口	单个 WebGL 模型查看器
INV-CLEAN-07：临时文件清理	失败即关闭的自动临时文件清理	场景状态会持续保留在内存中	留下 .py/.blend 临时文件	大型项目临时目录	远程云存储保留数据
INV-CROSS-08：跨平台	Windows、Linux、macOS 表现一致	取决于 GUI 桌面支持	路径处理依赖操作系统	受操作系统限制（主要为 Windows）	与平台无关的浏览器
INV-SYNC-09：锁定与同步防护	针对多主机锁定与同步进行了加固	容易发生文件锁冲突	不支持锁定感知	使用大型专有文件锁	不具备多设备 git 协作规范
INV-SLA-10：安全 SLA	承诺 48h 内受理 / 5d 内分流	社区尽力支持（无 SLA）	无正式支持	需要企业支持合同	通用 SaaS 工单队列

4. 架构与组件拓扑

ASCII 四视图架构拓扑

+--------------------------------------------------------------------------------------------------+
|                               ELLMOS BLENDER USE MCP ARCHITECTURAL TOPOLOGY                      |
+--------------------------------------------------------------------------------------------------+
| [VIEW 1: CALLER RUNTIMES & AGENT CLIENTS]                                                        |
|   * Autonomous Agents   : Claude Code, OpenAI Codex, Antigravity / Gemini, Kimi, Cursor          |
|   * Transport Protocols : Model Context Protocol (MCP stdio), JSON-RPC 2.0 framing               |
|   * Automation Entry    : npx -y ellmos-blender-use-mcp, CI/CD runners, local development shells |
|   * Tool Surface        : blender_verify_fbx_reimport, blender_verify_visual,                      |
|                           blender_run_script, blender_locate                                     |
+--------------------------------------------------------------------------------------------------+
|                                                |                                                 |
|                                                v                                                 |
+--------------------------------------------------------------------------------------------------+
| [VIEW 2: BLENDER USE MCP CORE ENGINE & DISCOVERY ORCHESTRATOR]                                   |
|   * Protocol Dispatch   : ESM stdio router with Zod schema validation & parameter checking       |
|   * Executable Resolver : Windows Registry / BLENDER_EXE / Program Files / PATH auto-discovery   |
|   * Bounded Supervision : 8 KB default tail buffer, 50 KB ceiling, hard child process kill tree  |
|   * Script Synthesizer  : Dynamic ephemeral Python QA script generation with fail-closed purge   |
+--------------------------------------------------------------------------------------------------+
|                                                |                                                 |
|                                                v                                                 |
+--------------------------------------------------------------------------------------------------+
| [VIEW 3: RUNTIME PERSISTENCE, VISUAL ASSET REPORTS & EPHEMERAL SCRIPTS]                          |
|   * Structural QA       : Headless FBX import, mesh/empty enumeration, material slot assignment  |
|   * Visual 4-View Engine: Orthogonal front, side, top & perspective rendering pipeline           |
|   * Anomaly Detectors   : Unapplied rotation, floating meshes, displaced origin/pivot, residuals |
|   * Deterministic Output: JSON test receipts with structured metrics, pass/fail status & counts  |
+--------------------------------------------------------------------------------------------------+
|                                                |                                                 |
|                                                v                                                 |
+--------------------------------------------------------------------------------------------------+
| [VIEW 4: AIR-GAP DEFENSE PERIMETER, RUNASINVOKER & ZERO-EGRESS]                                  |
|   * Security Model      : RunAsInvoker unprivileged execution (Zero administrative elevation)    |
|   * Network Isolation   : 100% Zero-Egress, zero telemetry, air-gapped offline operation         |
|   * Lifecycle Governance: Stateless execution (no resident daemon, no add-on mutation, no TCP)   |
|   * Supply Chain        : Level 1 SBOM, 100% permissive runtime (MIT/BSD), 48h Security SLA      |
+--------------------------------------------------------------------------------------------------+

组件流程图

graph TD
    subgraph Client ["AI Assistant & Client Environment"]
        AI["AI Agent (Claude / Codex / Gemini)"]
        Config["MCP Configuration (npx / node)"]
    end

    subgraph Server ["ellmos Blender Use MCP Server"]
        MCP["MCP Protocol Server (src/index.js)"]
        subgraph Tools ["Tool Handlers"]
            T1["blender_verify_fbx_reimport"]
            T2["blender_run_script"]
            T3["blender_locate"]
            T4["blender_verify_visual"]
        end
        Safety["Timeout & Tail Buffer Guard (8k chars)"]
    end

    subgraph Subprocess ["Headless Subprocess (Isolated)"]
        Exe["Blender Executable (blender --background)"]
        Python["Temp Python Verification Script"]
        FBX["Target FBX Asset File"]
        JSONOut["Deterministic JSON Result"]
    end

    AI -->|JSON-RPC Request| MCP
    MCP --> Tools
    T1 -->|Generates script & spawns| Exe
    T2 -->|Executes arbitrary python| Exe
    T3 -->|Locates binary| Exe
    T4 -->|Generates visual verification script & spawns| Exe
    Exe --> Python
    Python --> FBX
    FBX -->|Mesh / Material / Naming QA| JSONOut
    JSONOut --> Safety
    Safety -->|Bounded Response| AI

    style Client fill:#1e1e2e,stroke:#89b4fa,stroke-width:1px
    style Server fill:#181825,stroke:#cba6f7,stroke-width:1px
    style Subprocess fill:#11111b,stroke:#a6e3a1,stroke-width:1px

5. 无头资产 QA 验证生命周期

sequenceDiagram
    autonumber
    actor Client as AI Assistant / CI Pipeline
    participant Server as ellmos Blender Use MCP
    participant Resolver as Blender Resolver
    participant Process as Headless Subprocess
    participant Python as Blender Python Engine
    participant FS as Local Filesystem (FBX)

    Client->>Server: Call blender_verify_fbx_reimport(fbxPath, requiredPrefixes)
    Server->>Resolver: Resolve Blender Executable (blender_locate / BLENDER_EXE / Registry / PATH)
    Resolver-->>Server: Return Validated Executable Path
    Server->>FS: Write Temp Python Verification Script
    Server->>Process: Spawn blender --background --python script (timeout-guarded)
    Process->>Python: Execute Verification Script
    Python->>FS: bpy.ops.import_scene.fbx(filepath=fbxPath)
    FS-->>Python: Parse Mesh Objects & Material Slots
    Python->>Python: Validate Naming Prefixes, Object Counts & Hierarchy
    Python->>FS: Write Output JSON Verification Result
    Process-->>Server: Process Exit (Exit Code 0 / Bounded Tail Buffer)
    Server->>FS: Read Result & Clean Up Temp Verification Script
    Server-->>Client: Deterministic JSON Result (meshCount, materialCount, missingPrefixes, ok)

6. 工具套件与验证矩阵

工具	用途	主要输出	内存防护
`blender_verify_fbx_reimport`	生成临时 Blender 验证脚本，导入 FBX，并写入包含网格 / 材质计数和缺失必需前缀的 JSON 结果。	JSON 报告	尾部缓冲区限制为 8 KB
`blender_verify_visual`	渲染 FBX 的四个视图，并检查结构化重新导入无法发现的几何问题：未应用的旋转、悬空部件、模型外的枢轴、变换残余、零散的空对象。	4 张 PNG + JSON	尾部缓冲区限制为 8 KB
`blender_run_script`	使用可选参数和受限的 stdout 尾部运行 `blender --background --python <script.py>`。	脚本尾部文本	最大 8 KB - 50 KB
`blender_locate`	从显式路径、`BLENDER_EXE`、标准 Windows 安装位置或 PATH 中解析 Blender 可执行文件。	解析后的路径	不启动子进程

7. `blender_verify_fbx_reimport` 深入解析与架构

将 FBX 文件导入无头 Blender，并验证网格数量、空对象数量、材质数量、材质槽分配以及必需的命名前缀。

参数

参数	类型	必需	默认值	描述
`fbxPath`	`string`	是	—	要验证的目标 FBX 资源文件路径。
`resultPath`	`string`	否	`<fbxDir>/verify_reimport_result.json`	写入结构化 JSON 验证结果的路径。
`requiredPrefixes`	`string[]`	否	`[]`	网格或空对象必须具备的命名前缀列表（例如 `["SM_", "M_"]`）。
`blenderPath`	`string`	否	自动检测	Blender 可执行文件的自定义路径（`blender.exe` / `blender`）。
`timeoutMs`	`number`	否	`120000`	进程执行超时时间，单位为毫秒（最大值：`600000`）。

调用示例

{
  "fbxPath": "assets/models/SM_Watchtower_01.fbx",
  "requiredPrefixes": ["SM_", "M_"]
}

确定性输出架构

{
  "ok": true,
  "blender": "C:\\Program Files\\Blender Foundation\\Blender 4.2\\blender.exe",
  "fbxPath": "C:\\projects\\game\\assets\\models\\SM_Watchtower_01.fbx",
  "resultPath": "C:\\projects\\game\\assets\\models\\verify_reimport_result.json",
  "exitCode": 0,
  "timedOut": false,
  "durationMs": 1820,
  "outputTruncated": false,
  "verification": {
    "ok": true,
    "fbx": "C:\\projects\\game\\assets\\models\\SM_Watchtower_01.fbx",
    "mesh_count": 3,
    "empty_count": 0,
    "material_count": 2,
    "materials": [
      "M_Stone_Brick",
      "M_Wood_Trim"
    ],
    "missing_prefixes": [],
    "script_free": true
  }
}

8. 视觉验证深入解析与四视图几何

渲染 FBX 的四个视图，并检查结构重新导入无法发现的几何问题。

blender_verify_fbx_reimport 会统计网格并检查名称前缀，但无法判断网格是否侧躺、零件是否漂离装配体，或枢轴是否位于模型之外。此工具可以检查这些问题，并生成渲染图供你查看。

{ "fbxPath": "kit.fbx", "outDir": "verify_visual", "expectHeight": "2.5,3.5" }

四视图正交投影与故障检测

+---------------------------------------+---------------------------------------+
|              TOP VIEW                 |           PERSPECTIVE VIEW            |
|              (XY Plane)               |              (Isometric)              |
|                                       |                                       |
|   Detects: X/Y planar alignment,      |   Detects: Overall silhouette,        |
|   bounding box symmetry, footprint    |   complex assembly integration        |
+---------------------------------------+---------------------------------------+
|             FRONT VIEW                |               SIDE VIEW               |
|              (XZ Plane)               |              (YZ Plane)               |
|                                       |                                       |
|   Detects: Model height, Z-grounding, |   Detects: Depth errors, floating vs  |
|   upright orientation (lying down)    |   resting parts, pivot offset         |
+---------------------------------------+---------------------------------------+

检测到的故障类别：未应用的旋转、多零件资源中的漂浮零件、位于边界框之外的枢轴／原点、导出中的变换残留、游离的空对象。

确定性输出架构

{
  "ok": true,
  "blender": "C:\\Program Files\\Blender Foundation\\Blender 4.2\\blender.exe",
  "fbxPath": "C:\\projects\\game\\kit.fbx",
  "outDir": "C:\\projects\\game\\verify_visual",
  "exitCode": 0,
  "timedOut": false,
  "durationMs": 3450,
  "outputTruncated": false,
  "verification": {
    "ok": true,
    "fails": [],
    "warns": [],
    "metrics": {
      "dimensions": [2.45, 1.82, 4.10],
      "center": [0.0, 0.0, 2.05],
      "pivotAtOrigin": true,
      "unappliedRotation": false
    }
  },
  "renders": {
    "view_front": "verify_visual/view_front.png",
    "view_side": "verify_visual/view_side.png",
    "view_top": "verify_visual/view_top.png",
    "view_perspective": "verify_visual/view_perspective.png"
  }
}

**为什么需要四个视图，而不是一个：**单张正面图会掩盖深度错误——例如漂浮与贴地、位于后方与前方。一个真实案例：链环从正面看似乎连接正确，从侧面看却完全没有连接。

与这里的所有工具一样，它是一次性无头运行：无需插件、守护进程或套接字。

9. 通用基础工具（`blender_locate` 与 `blender_run_script`）

blender_locate：在 Windows、Linux 或 macOS 上解析当前使用的 Blender 可执行文件，依次检查显式调用参数、环境变量 BLENDER_EXE、标准安装路径（从最新版本开始）以及系统 PATH。
blender_run_script：通过 blender --background --python <script.py> 运行任意本地 Python 脚本，支持可选参数、超时保护以及硬性尾部缓冲区截断（默认 8 KB，最大 50 KB）。

10. CI/CD 流水线集成（GitHub Actions）

将无头资源 QA 直接集成到 GitHub Actions 的拉取请求检查中，防止损坏的 FBX 模型、缺失的材质槽、未应用的旋转以及偏移的枢轴进入主分支：

name: 3D Asset QA Gate

on:
  pull_request:
    paths:
      - "assets/**/*.fbx"

jobs:
  verify-assets:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout Repository
        uses: actions/checkout@v4

      - name: Install Blender & Node.js
        run: |
          sudo snap install blender --classic
          sudo apt-get install -y nodejs npm

      - name: Run Headless Asset Verification
        run: |
          npx -y ellmos-blender-use-mcp --version
          # Run structural FBX QA and 4-view visual verification
          blender --background --factory-startup --python node_modules/ellmos-blender-use-mcp/scripts/verify_asset_visual.py -- \
            --fbx assets/models/SM_HeroAsset.fbx \
            --out build/asset-qa/ \
            --json

11. 治理与运行时不变量

该服务强制执行 10 项架构和运行时不变量，以确保隐私、安全、进程隔离和可审计性：

ID	不变量	保障与实现细节
`INV-LOCAL-01`	100% 本地优先且零网络流出	不发送任何出站网络请求、外部遥测数据或远程 API 调用。可在主机上完全隔离网络运行。
`INV-HEADLESS-02`	无状态且无需附加组件的无头执行	无需安装 Blender 附加组件，不开放 TCP 套接字或守护进程监听器，且不会对主机的 Blender 用户目录进行任何修改。
`INV-SEC-03`	不提升权限，以非特权 RunAsInvoker 运行	严格以非特权用户模式权限（`RunAsInvoker`）运行。绝不需要或请求管理员权限提升。
`INV-BOUND-04`	严格的超时与尾部缓冲区限制	每次执行均受超时保护。标准输出和错误流会捕获到有界尾部缓冲区中（默认 8 KB，最大 50 KB），以防止内存失控。
`INV-INTEG-05`	确定性 JSON 与证据完整性	生成可验证、机器可读的 JSON 报告，其中包含精确的网格计数、材质槽、命名前缀和几何指标。
`INV-VISUAL-06`	四视角多角度视觉验证	生成正交前视图、侧视图、顶视图和透视图渲染，以检测深度盲区检查会遗漏的几何缺陷（部件悬空、旋转未应用）。
`INV-CLEAN-07`	失败即关闭的临时暂存与脚本清理	临时 Python 验证脚本和暂存文件会在完成或失败后从文件系统中无条件清除。
`INV-CROSS-08`	跨平台操作系统一致性	在 Windows、Linux 和 macOS 上实现统一执行与自动发现，不依赖硬编码的主机环境。
`INV-SYNC-09`	云同步与多主机锁纪律	可抵御云同步冲突（`-conflict-`、`-CONFLIT-`），并遵守规范的多 Agent 锁机制。
`INV-SLA-10`	48 小时安全响应与 5 天分类处理 SLA	通过官方协调渠道，在 48 小时内正式确认漏洞，并承诺在 5 个工作日内完成分类处理。

12. 安全策略与 RunAsInvoker

本地 Python 执行：此服务会在 Blender 中运行本地 Python。仅使用你信任的脚本和资产路径。
RunAsInvoker 不提升权限：严格以标准非特权用户帐户运行；无需管理员或 root 权限。
进程清理：子进程会受到监控；Windows 进程超时后会通过 taskkill /pid <PID> /T /F 正常终止。
离线保障：不涉及远程资产市场、外部 API 或使用情况遥测。
漏洞披露：请查看 SECURITY.md，了解官方协调联系人和具有约束力的 48 小时响应 SLA。

13. 安装与入门

选项 1：通过 npx 运行（无需安装）

{
  "mcpServers": {
    "blender-use": {
      "command": "npx",
      "args": ["-y", "ellmos-blender-use-mcp"]
    }
  }
}

选项 2：从源代码安装

git clone https://github.com/ellmos-ai/ellmos-blender-use-mcp.git
cd ellmos-blender-use-mcp
npm install
npm run build
node src/index.js

对于本地克隆的代码库，请将 command/args 指向克隆的 src/index.js：

{
  "mcpServers": {
    "blender-use": {
      "command": "node",
      "args": ["<path-to-repo>/src/index.js"]
    }
  }
}

14. 配置与环境

BLENDER_EXE — Blender 可执行文件的可选路径。未设置时，工具会依次尝试显式的 blenderPath 参数、BLENDER_EXE、Windows 上的标准 Blender 安装位置（%ProgramFiles%\Blender Foundation\Blender <version>\blender.exe 及对应的 32 位和每用户目录，优先选择最新版本），最后查找 PATH。在 Linux 和 macOS 上，查找会从 BLENDER_EXE 直接转到 PATH。
每个工具也都支持在调用时传入显式的 blenderPath 参数，其优先级高于 BLENDER_EXE。
进程输出仅保留末尾部分：blender_run_script 默认保留 8,000 个字符（可配置，最高为 50,000 个字符）；FBX 验证会保留 8,000 个字符。如果更早的输出已被丢弃，响应中会标记 outputTruncated: true，因此即使 Blender 脚本输出冗长，也不会导致 MCP 进程的内存无限增长。

15. 第三方许可证与 Level 1 SBOM

所有运行时生产依赖均采用宽松的开源许可证（MIT 和 BSD-2-Clause）发布，传染性要求为 0%：

@modelcontextprotocol/sdk（MIT）
update-notifier（BSD-2-Clause）
zod（MIT）

完整的依赖清单、不变量交叉引用矩阵以及现有技术隔离分析，请参阅 THIRD_PARTY_LICENSES.md 和配套的纯文本清单 THIRD_PARTY_LICENSES.txt。

16. 同系列项目与 ellmos-ai 生态系统

此 MCP 服务属于 ellmos-ai 生态系统，涵盖 AI 基础设施、MCP 服务和智能工具。

MCP 服务系列

服务	工具	侧重领域	npm
FileCommander	46	文件系统、进程管理、交互式会话、云锁安全操作	`ellmos-filecommander-mcp`
CodeCommander	22	代码分析、JSON 修复、导入、差异、正则表达式	`ellmos-codecommander-mcp`
Clatcher	12	文件修复、格式转换、批量操作	`ellmos-clatcher-mcp`
n8n Manager	18	通过 AI 助手管理 n8n 工作流	`n8n-manager-mcp`
ControlCenter	20	MCP 技术栈发现、配置文件管理、控制平面	`ellmos-controlcenter-mcp`
Homebase	45	本地优先的大模型记忆、知识、状态、路由与群体编排	`ellmos-homebase-mcp`（alpha）
ServerCommander	8	服务端运维：运行状况检查、日志分析、部署演练、邮件诊断	`ellmos-servercommander-mcp`（alpha）
Blender Use	4	无头 Blender 资产 QA：FBX 结构重新导入检查与四视图视觉验证	`ellmos-blender-use-mcp`（alpha）
Open Compute	10	与模型无关的计算机操控：捕获、安全门控操作、Windows UIA	`open-compute-mcp`（alpha）

AI 基础设施与开发者工具

项目	描述
workflowhooker	面向 Agent 工作流的透明命令拦截器与安全沙箱
system-explorer	系统检查、MCP 编排与集群自省运行时
memoryhooker	面向 AI Agent 的高性能情景记忆拦截器
policy-registry	面向多 Agent 框架的策略分发与合规引擎
ellmos-delegation-authority	信任边界验证与加密令牌委派权威服务
sqlite-transit-sync	采用快照隔离的事务型 SQLite 中转复制
BACH	面向大模型 Agent 的本地优先文本型操作系统——113+ 个处理器、550+ 个工具、SQLite 记忆
open-compute	为 Open Compute MCP 提供支持的模型无关型计算机操作核心
clutch	提供自动路由与预算跟踪的供应商中立型大模型编排
rinnsal	轻量级 Agent 记忆、连接器与自动化基础设施
ellmos-stack	可自托管的 AI 研究技术栈（Ollama + n8n + Rinnsal + KnowledgeDigest）
MarbleRun	面向 Claude Code 的自主 Agent 链框架
gardener	极简的数据库驱动型大模型操作系统原型（4 个函数、1 张表）
ellmos-tests	大模型操作系统测试框架（7 个维度）

桌面软件套件与相关工具

我们的合作组织 open-bricks 集成了 AI 原生桌面应用与开发者实用工具，组成一套面向 AI 时代的现代开源软件套件：

项目	生态系统	描述
ProFiler	`file-bricks`	高级文件管理、深度检查与批处理流水线工作台
DokuZen	`doc-bricks`	统一的文档转换器、Markdown 格式化工具与文档中心
PDFtoPDFocr	`doc-bricks`	高保真 OCR 处理器与可搜索 PDF 流水线
FormularErstellen	`doc-bricks`	声明式表单生成器与 PDF 模式编译器
MediaBrain	`file-bricks`	AI 辅助的媒体分类、标记与资产管理
TextBrain	`doc-bricks`	文本分析、摘要与本地语言智能套件
knowledgedigest	`open-bricks`	知识提取、语义聚类与综合引擎
DevCenter	`dev-bricks`	开发者环境编排与多 Agent 管理驾驶舱
CodeBox	`dev-bricks`	安全执行沙箱与隔离式代码运行时
BattleStage	`entertain-and-more`	模块化战术游戏竞技场，带有自动化资产流水线验证

17. LLM 上下文索引（`llms.txt`）

对于 AI 助手和 LLM 工具，llms.txt 提供机器可读的架构文档、工具描述、搜索短语和运行时不变量。

18. 许可证与法定免责声明（《德国民法典》第 521 条）

许可证与署名

本项目根据 MIT License 分发。有关完整的版权和署名详情，请参阅 LICENSE 和 NOTICE。

德国法定免责声明（《德国民法典》第 521 条，情谊行为）

此开源软件包免费提供，不收取对价（情谊行为）。根据德国法定法律（《德国民法典》第 521 条），对于质量和权利瑕疵，仅在故意行为和重大过失的情况下承担责任。

安全响应承诺

我们会在 48 小时内根据具有约束力的安全 SLA 对安全漏洞进行分级处理。有关协调披露指南，请参阅 SECURITY.md。

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

ellmos Blender Use

关于 ellmos Blender Use

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

ellmos Blender Use MCP

快速导航

1. 主要功能

2. 目标用户与高意向搜索

[PERSONA-01] 独立游戏与 AAA 游戏技术美术师及 3D 管线 TD

[PERSONA-02] CI／CD 自动化与构建基础设施工程师

[PERSONA-03] 自主 AI Agent 工程师（Claude、Codex、Gemini）

[PERSONA-04] 企业游戏工作室合规与安全官

3. 与替代方案的 10 维对比矩阵

4. 架构与组件拓扑

ASCII 四视图架构拓扑

组件流程图

5. 无头资产 QA 验证生命周期

6. 工具套件与验证矩阵

7. blender_verify_fbx_reimport 深入解析与架构

参数

调用示例

确定性输出架构

8. 视觉验证深入解析与四视图几何

四视图正交投影与故障检测

确定性输出架构

9. 通用基础工具（blender_locate 与 blender_run_script）

10. CI/CD 流水线集成（GitHub Actions）

11. 治理与运行时不变量

12. 安全策略与 RunAsInvoker

13. 安装与入门

选项 1：通过 npx 运行（无需安装）

选项 2：从源代码安装

14. 配置与环境

15. 第三方许可证与 Level 1 SBOM

16. 同系列项目与 ellmos-ai 生态系统

MCP 服务系列

AI 基础设施与开发者工具

桌面软件套件与相关工具

17. LLM 上下文索引（llms.txt）

18. 许可证与法定免责声明（《德国民法典》第 521 条）

许可证与署名

德国法定免责声明（《德国民法典》第 521 条，情谊行为）

安全响应承诺

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？

7. `blender_verify_fbx_reimport` 深入解析与架构

9. 通用基础工具（`blender_locate` 与 `blender_run_script`）

17. LLM 上下文索引（`llms.txt`）