Skip to main content
Glama
xiaohai-uid

Blender-Mind-MCP

by xiaohai-uid

Blender-Mind-MCP(本番向けAI 3Dモデリング&Blenderブリッジ)

自動化3Dモデリング、プロシージャルアセット生成、シェーダー作成、マルチモーダルビューポート検査のための、本番グレードのModel Context Protocol(MCP)サーバーおよびBlenderアドオンエコシステムです。


🏗️ 先行技術とアーキテクチャの着想

本プロジェクトは、主要なGitHub Blender AIプロジェクト(ahujasid/blender-mcpdjeada/blender-mcp-serverなど)から得たアーキテクチャ上の教訓とベンチマークを取り入れています。

  1. スレッドセーフなメインスレッドディスパッチ:BlenderのPython C-API(bpy)はスレッドセーフではありません。コミュニティのイシュー監査で判明したように、生のソケットリスナースレッド内でbpy呼び出しを実行すると、メモリ破損やセグメンテーションフォルトが発生します。当社のBlenderアドオンは、スレッドセーフなqueue.Queuebpy.app.timersと組み合わせて使用し、すべてのシーン変更がBlenderのメインレンダー/GUIループ内で厳密に実行されるようにしています。

  2. アンドゥステップの分離:すべてのAIコード実行はbpy.ops.ed.undo_push()で囲まれ、Blender内でのシームレスなCtrl+Zロールバックを可能にします。

  3. マルチモーダルビューポートキャプチャ:オフスクリーンOpenGLレンダリング(bpy.ops.render.opengl)を使用して、3DビューポートのBase64エンコードされたPNGスクリーンショットをマルチモーダルビジョンモデルに直接返します。

  4. ヘクサゴナルアーキテクチャ(ポート&アダプター):純粋な3Dジオメトリ生成を物理ドライバーから分離し、ライブソケット接続(127.0.0.1:9876)、ヘッドレスCLIバッチ処理(blender -b)、オフラインのプロシージャルglTFバイナリシミュレーションの両方をサポートします。


Related MCP server: Blender MCP Server

📦 プロジェクト構造

blender-mind-mcp/
├── addon/
│   └── blender_mcp_addon.py       # Full Blender 3.x/4.x Addon (UI Sidebar Panel, Socket Server, Viewport Capture)
├── src/
│   ├── index.ts                   # stdio JSON-RPC MCP Server entry point
│   ├── bridge/
│   │   └── socket_client.ts       # Robust TCP Socket Client with reconnect & timeout handling
│   ├── core/
│   │   └── domain/
│   │       ├── types.ts           # 3D Domain Types (Scene, Mesh, Material, Modifier, Transform)
│   │       ├── scene.ts           # Pure in-memory 3D scene graph & polygon math
│   │       └── bpy_generator.ts   # Modern Blender 4.x/3.x Python code synthesizer
│   ├── ports/
│   │   └── driver.port.ts         # BlenderDriverPort interface specification
│   ├── adapters/
│   │   ├── live_socket.adapter.ts # Live Socket Adapter (talks to active Blender GUI)
│   │   ├── blender_cli.adapter.ts # Headless CLI Adapter (talks to blender.exe)
│   │   └── mock_geometry.adapter.ts # Offline Simulation Adapter (glTF & OBJ binary synthesis)
│   └── tools/
│       └── index.ts               # 10 MCP Tools registry & dispatcher
├── tests/
│   ├── unit/                      # L1: Domain math & Python code generation
│   ├── contract/                  # L2: MCP tool schemas & argument contracts
│   ├── integration/               # L3: Binary glTF headers & TCP Socket Bridge
│   └── run_tests.ts               # Complete Truth Ladder test runner
├── package.json
└── tsconfig.json

🚀 クイックスタート

1. Blenderにアドオンをインストール

  1. Blender(3.6+または4.x)を開きます。

  2. 編集 > プリファレンス > アドオン > インストール...(または4.2+ではディスクからインストールの矢印)に移動します。

  3. addon/blender_mcp_addon.pyを選択します。

  4. 開発: Blender MCP Bridgeを有効にします。

  5. 3DビューポートでNを押してサイドバーを開き、Blender MCPタブをクリックし、Start MCP Serverをクリックします。

2. MCPクライアントを設定(Antigravity / Claude / Codex)

プロジェクトまたはグローバルMCP設定(.mcp.json)に追加します:

{
  "mcpServers": {
    "blender": {
      "command": "node",
      "args": [
        "--disable-warning=ExperimentalWarning",
        "--experimental-strip-types",
        "C:/Users/a1691/Documents/antigravity/noble-hypatia/src/index.ts"
      ]
    }
  }
}

🛠️ 10のコアMCPツール

ツール名

説明

主な機能

blender_create_primitive

プロシージャル3Dメッシュを作成

cubespherecylindertorusplaneconemonkey

blender_apply_modifier

プロシージャルモディファイアを適用

subsurfbevelbooleanmirrorarraysolidify

blender_procedural_material

PBR準拠のBSDFシェーダー

base_colormetallicroughnesstransmission(ガラス)、emission

blender_setup_lighting

光源の配置と調整

SUNPOINTSPOTAREA(ワット数、半径、色合い)

blender_setup_camera

カメラのフレーミングとレンズ

locationlook_atトラッキング、focal_length(mm)

blender_capture_viewport

ビューポートのビジュアルスナップショット

Base64 PNG画像をマルチモーダルLLMに直接返す

blender_export_asset

3Dモデルのベイクとエクスポート

.glb.gltf.obj.stl.fbx

blender_inspect_scene

トポロジとシーンツリーの検査

階層オブジェクトリスト、ポリゴン数、頂点数、モディファイア

blender_execute_bpy

生のパラメータPython実行

stdout/stderrキャプチャ付きのサンドボックス実行

blender_health

システム診断

アクティブドライバー、ポートステータス、Blenderビルドを報告


🧪 トゥルースラダー検証

npm test

4レベルのトゥルースラダーにわたって、全6つのテストスイートを実行します:

  • L1 ユニット:100%純粋なドメインモデリングとPythonコードシンセサイザーASTチェック。

  • L2 コントラクト:全10ツールのスキーマ定義とディスパッチ検証。

  • L3 インテグレーション:バイナリglTF v2ヘッダー(0x46546C67)とOBJ構造の検証。

  • L3 インテグレーション127.0.0.1:9899でのライブTCPソケットクライアント-サーバーループバックテスト。

  • L4 E2E:ライブstdio JSON-RPCパイプラウンドトリップ。

Install Server
A
license - permissive license
A
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Control Unreal Engine to browse assets, import content, and manage levels and sequences. Automate…

  • AI visual generation agent: multi-pipeline rendering, prompt crafting, and image composition.

  • Build and run visual creative-production workflows from your AI agent.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/xiaohai-uid/blender-mind-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server