MCP Link Blender

🚀 Blender用MCP-Link

BlenderをAIで制御可能な3D作成プラットフォームに変える

Blender用MCP-Linkは、Model Context Protocol (MCP)を通じてBlenderの全Python APIをAIエージェントに公開します。ハードコードされたコマンドはありません。純粋で汎用的なAPIアクセスにより、AIはBlenderができることをすべて実行できます。

🚀 クイックスタート

この拡張機能を使用すると、BlenderをAIエージェントで制御できる3D作成プラットフォームに変えることができます。以下のセクションでは、インストール方法、使用例、その他の詳細を説明します。

✨ 主な機能

• ✅ 100%汎用API - あらゆるBlenderコマンドで動作します。
• ✅ 完全なPythonアクセス - 完全なbpyアクセスで任意のPythonコードを実行できます。
• ✅ 永続セッション - 複数のAIコマンド間で変数が保持されます。
• ✅ MCPツールエコシステム - SQLite、ブラウザーオートメーション、システム制御などが利用できます。
• ✅ 自動接続 - 拡張機能は起動時にMCP-Linkサーバーに自動的に接続します。
• ✅ 自動再接続 - 接続が切断された場合でも適切に対応します。
• ✅ スレッドセーフ - Blender API呼び出しのメインスレッドでの適切な実行を保証します。

📦 インストール

方法1: Blender拡張機能から

1. Blenderを開きます。
2. 編集 → 設定 → 拡張機能を取得 に移動します。
3. "MCP-Link"を検索します。
4. インストール をクリックします。

方法2: ZIPファイルから

1. リリース から mcp_link_blender-x.x.x.zip をダウンロードします。
2. Blenderを開きます。
3. 編集 → 設定 → アドオン に移動します。
4. ディスクからインストール... をクリックします。
5. ZIPファイルを選択します。

方法3: コマンドライン

blender --command extension install-file -r user_default -e mcp_link_blender-1.0.0.zip

💻 使用例

3Dキューブを作成する

{
  "operation": "execute_python",
  "code": "import bpy\nbpy.ops.mesh.primitive_cube_add(size=2, location=(0, 0, 1))\nprint(f'Created: {bpy.context.active_object.name}')"
}

完全なシーンを作成する

{
  "operation": "execute_python",
  "code": "import bpy\n\n# Clear scene\nbpy.ops.object.select_all(action='SELECT')\nbpy.ops.object.delete()\n\n# Add ground plane\nbpy.ops.mesh.primitive_plane_add(size=10)\n\n# Add a sphere\nbpy.ops.mesh.primitive_uv_sphere_add(radius=1, location=(0, 0, 1))\nsphere = bpy.context.active_object\n\n# Add material\nmat = bpy.data.materials.new('Red')\nmat.diffuse_color = (1, 0, 0, 1)\nsphere.data.materials.append(mat)\n\nprint('Scene created!')"
}

ファイルにレンダリングする

{
  "operation": "execute_python",
  "code": "import bpy\nbpy.context.scene.render.filepath = '/tmp/render.png'\nbpy.ops.render.render(write_still=True)\nprint('Rendered!')"
}

ソースからビルドする

# リポジトリをクローンする
git clone https://github.com/AuraFriday/mcp_link_blender.git
cd MCP-Link-Blender

# 拡張機能をビルドする
make build

# Blenderにインストールする
make install

Makefileコマンド

🔧 技術詳細

1. 拡張機能の読み込み：Blenderが起動すると拡張機能が読み込まれます。
2. 自動接続：SSEを介してローカルのMCP-Linkサーバーに自動的に接続します。
3. リモートツールの登録："blender"をリモートツールとして登録します。
4. コマンドの待機：AIエージェントからのコマンドを待機します。
5. メインスレッドでの実行：スレッドセーフのためにbpy.app.timersを介してメインスレッドでコマンドを実行します。
6. 結果の返却：AIエージェントに結果を返します。

📄 ライセンス

GPL-3.0-or-later - 詳細は LICENSE を参照してください。

トラブルシューティング

拡張機能が接続しない場合

1. MCP-Linkサーバーが起動していることを確認してください。
2. Blenderのシステムコンソールでエラーメッセージを確認してください。
3. サーバーが予期されるポートで待機していることを確認してください。

コマンドが実行されない場合

1. ほとんどの操作ではBlenderがオブジェクトモードであることを確認してください。
2. 操作する前に必要なオブジェクトが存在することを確認してください。
3. レスポンスのエラーメッセージを確認してください。

コントリビュート

コントリビューションは大歓迎です！ガイドラインについては CONTRIBUTING.md を参照してください。

クレジット

オーラフライデー によって作成されました - 以前のアドインの15,000人以上のユーザーに信頼されています。

リンク:

• MCP-Linkサーバーのダウンロード
• GitHubリポジトリ
• イシュートラッカー