Blender-Mind-MCP
Blender-Mind-MCP(本番向けAI 3Dモデリング&Blenderブリッジ)
自動化3Dモデリング、プロシージャルアセット生成、シェーダー作成、マルチモーダルビューポート検査のための、本番グレードのModel Context Protocol(MCP)サーバーおよびBlenderアドオンエコシステムです。
🏗️ 先行技術とアーキテクチャの着想
本プロジェクトは、主要なGitHub Blender AIプロジェクト(ahujasid/blender-mcpやdjeada/blender-mcp-serverなど)から得たアーキテクチャ上の教訓とベンチマークを取り入れています。
スレッドセーフなメインスレッドディスパッチ:BlenderのPython C-API(
bpy)はスレッドセーフではありません。コミュニティのイシュー監査で判明したように、生のソケットリスナースレッド内でbpy呼び出しを実行すると、メモリ破損やセグメンテーションフォルトが発生します。当社のBlenderアドオンは、スレッドセーフなqueue.Queueをbpy.app.timersと組み合わせて使用し、すべてのシーン変更がBlenderのメインレンダー/GUIループ内で厳密に実行されるようにしています。アンドゥステップの分離:すべてのAIコード実行は
bpy.ops.ed.undo_push()で囲まれ、Blender内でのシームレスなCtrl+Zロールバックを可能にします。マルチモーダルビューポートキャプチャ:オフスクリーンOpenGLレンダリング(
bpy.ops.render.opengl)を使用して、3DビューポートのBase64エンコードされたPNGスクリーンショットをマルチモーダルビジョンモデルに直接返します。ヘクサゴナルアーキテクチャ(ポート&アダプター):純粋な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にアドオンをインストール
Blender(3.6+または4.x)を開きます。
編集 > プリファレンス > アドオン > インストール...(または4.2+ではディスクからインストールの矢印)に移動します。
addon/blender_mcp_addon.pyを選択します。開発: Blender MCP Bridgeを有効にします。
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ツール
ツール名 | 説明 | 主な機能 |
| プロシージャル3Dメッシュを作成 |
|
| プロシージャルモディファイアを適用 |
|
| PBR準拠のBSDFシェーダー |
|
| 光源の配置と調整 |
|
| カメラのフレーミングとレンズ |
|
| ビューポートのビジュアルスナップショット | Base64 PNG画像をマルチモーダルLLMに直接返す |
| 3Dモデルのベイクとエクスポート |
|
| トポロジとシーンツリーの検査 | 階層オブジェクトリスト、ポリゴン数、頂点数、モディファイア |
| 生のパラメータPython実行 | stdout/stderrキャプチャ付きのサンドボックス実行 |
| システム診断 | アクティブドライバー、ポートステータス、Blenderビルドを報告 |
🧪 トゥルースラダー検証
npm test4レベルのトゥルースラダーにわたって、全6つのテストスイートを実行します:
L1 ユニット:100%純粋なドメインモデリングとPythonコードシンセサイザーASTチェック。
L2 コントラクト:全10ツールのスキーマ定義とディスパッチ検証。
L3 インテグレーション:バイナリglTF v2ヘッダー(
0x46546C67)とOBJ構造の検証。L3 インテグレーション:
127.0.0.1:9899でのライブTCPソケットクライアント-サーバーループバックテスト。L4 E2E:ライブstdio JSON-RPCパイプラウンドトリップ。
Maintenance
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
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to control Blender 3D software through natural language commands, supporting object creation, manipulation, materials, rendering, and scene management with 22 tools organized across 6 categories.
- AlicenseNot gradedqualityDmaintenanceExposes 50+ Blender tools (object manipulation, materials, animation, etc.) via MCP for AI-driven 3D workflows and automation.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI-powered 3D content creation in Blender through natural language, including text-to-3D, image-to-3D, animation, rigging, rendering, and export.2MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to control Blender via MCP tools for scene manipulation, material assignment, rendering, and Python script execution.22MIT
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.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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