bpy-dev/blender-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

97 stars 9 forks 品質 73 トレンド 8GPL-3.0

Repository Install

Blender Lab MCPの独立した強化配布:スタンドアロンのBPY、ランタイムAPIドキュメント、ベンチマークツール

概要

このブランチは、エージェント型Blender作業のための強化されたBlender MCPワークフローをパッケージ化します。上流のライブBlenderアドオン/サーバーモデルを維持し、保存ファイル/ヘッドレス実行、選択可能なコマンドラインバックエンド、ランタイムでのBlender Python API検索、サブプロセス/キャプチャ強化、ベンチマークツールを追加しています。これはBlender LabのBlender MCPプロジェクトの修正版ディストリビューションです。実行リスクモデルについては出所と SECURITY.md については NOTICE.md を参照してください。公開 bpy.dev ウェブサイトの資産は別のリポジトリに保管されます。コンピレーションはをカバーしています。そのオンビデオの「CLIP accuracy」ラベルはを意味します。リンクされた不変のH.264ビデオは848×464、134.9秒、10,161,884バイトです。SHA-256:04966320de680203baed6c01c3e211059350454139dc8a802c557cce24815c17。 - _for_cliツールはライブのBlender UIセッションを必要とせず、新しいサブプロセスの.blendファイルを操作します。- Blenderの実行可能なバックエンドまたはBLENDER_MCP_CLI_BACKENDと組み合わせたスタンドアロンのbpy Pythonバックエンドを使用すること。

概要（AI 翻訳）

強化MCP開発者プレビュー

これはBlender LabのBlender MCPプロジェクトの修正版ディストリビューションです。実行リスクモデルについては出所と SECURITY.md については NOTICE.md を参照してください。公開 bpy.dev ウェブサイトの資産は別のリポジトリに保管されます。

BlenderBenchの結果

このコンピレーションは27タスク/270発をカバーしています。ビデオ上の「クリップ精度」ラベルは、つまり CLIP 画像埋め込みコサイン類似性、文字通りの正確さではありません。リンクされた不変 H.264ビデオは848×464、134.9秒、10,161,884バイトです。SHA-256: 04966320de680203baed6c01c3e211059350454139dc8a802c557cce24815c17。

強化されたもの

保存ファイルツール: _for_cliツールはライブのBlender UIセッションを必要とせず、新しいサブプロセスの.blendファイルを操作します。
バックエンド選択: Blenderの実行可能なバックエンドか、bpyのスタンドアロンのPythonバックエンド(BLENDER_MCP_CLI_BACKEND)を使用してください。

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Blender MCP

Enhanced MCP developer preview

This branch packages an enhanced Blender MCP workflow for agentic Blender work. It keeps the upstream live Blender add-on/server model and adds saved-file/headless execution, selectable command-line backends, runtime Blender Python API lookup, subprocess/capture hardening, and benchmark tooling.

This is a modified distribution of Blender Lab’s Blender MCP project. See NOTICE.md for provenance and SECURITY.md for the execution-risk model. Public bpy.dev website assets will live in a separate repository.

BlenderBench result

The compilation covers 27 tasks / 270 rounds. Its on-video “CLIP accuracy” label means CLIP image-embedding cosine similarity, not literal accuracy. The linked immutable H.264 video is 848×464, 134.9 seconds, and 10,161,884 bytes; SHA-256: 04966320de680203baed6c01c3e211059350454139dc8a802c557cce24815c17.

What is enhanced

Saved-file tools: _for_cli tools operate on .blend files in fresh subprocesses without requiring a live Blender UI session.
Backend selection: use a Blender executable backend or a standalone bpy Python backend with BLENDER_MCP_CLI_BACKEND.
Runtime API lookup: agents can query exact signatures, enums, defaults, and availability from the active Blender/bpy runtime instead of relying only on bundled docs.
Process isolation: command-line executions are bounded by explicit timeouts, output caps, compact JSON framing, and source-file overwrite checks. This is crash/process-state isolation, not an OS sandbox.
Benchmark tooling: deterministic token-efficiency tasks, exploratory creative comparison harnesses, and a portable model-neutral full-27 BlenderBench runner with pinned inputs and post-generation scoring.

Current publication status

Developer-preview cleanup is in progress. Before publishing, complete PUBLICATION_CHECKLIST.md, especially package naming, fresh-clone install smoke tests, and tracked-file secret scanning.

Overview

A lightweight MCP (Model Context Protocol) server for Blender. It offers a natural language interface with Blender’s Python API, improving access to documentation, and allowing users to explore and understand complex setups.

Read the documentation at blender.org/lab/mcp-server

The project is deliberately small, maintainable, and does no more than necessary. It has two components that communicate over a TCP socket:

A Blender add-on that runs inside Blender and executes live-scene requests.
An MCP server that runs as a separate process, launched by the

GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "blender": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/blender_mcp/mcp",
        "run",
        "blender-mcp"
      ],
      "env": {
        "BLENDER_MCP_CLI_BACKEND": "bpy",
        "BLENDER_MCP_BPY_PYTHON": "/absolute/path/to/python-with-bpy"
      }
    }
  }
}