ViperMesh for Blender

---

Blender 用 ViperMesh は、対応する AI アシスタントが Blender のシーン内で作業できるようにする、無料のオープンソース Blender MCP サーバーおよびアドオンです。新たなコーディングプロジェクトではなく、3D シーンの作成や編集を手助けしてほしい Blender アーティスト、ホビイスト、ゲームクリエイター向けです。

目標：AI を活用した作業を高速化し、AI トークンを節約して、結果をより適切に確認できるようにすることです。 一般的な編集の多くで新しい Python コードを書かなくても済むよう、アシスタントはすぐに使える Blender のアクションを利用できます。Blender で作業を続けながら、アシスタントに手助けしてほしい内容は自分で決められます。

概要を見る

72 秒の動画を見る またはMP4 をダウンロードしてください。AI クライアントがすぐに使える Blender のアクションをどのように利用するか、生成コードを減らすことが役立つ理由、そして利用を始める方法をご覧いただけます。これは、ベンチマークの時間計測を記録したものではなく、音声のないイラスト付きの概要動画です。GitHub の README から再生可能な動画にアクセスできます。

Blender 用 ViperMesh を選ぶ理由

重視する点	ViperMesh によるサポート
AI の利用を減らす	再利用可能なアクションにより、対応するタスクでアシスタントが生成する Blender コードを減らせます。
待ち時間を減らす	接続が維持され、各ステップでセットアップを繰り返すことなく、関連するアクションをまとめて実行できます。
シーンをより適切に確認する	組み込みのチェックで、浮いているオブジェクト、向きの誤り、クリアランスの問題を見つけることができます。アシスタントは画像を確認し、誤りを修正できます。
アシスタントが使いやすい	見つけやすいツールと簡潔なガイダンスにより、利用できるアクションとその使い方がわかります。
独自の作業にも対応	すぐに使えるツールでは対応できない依頼には、アシスタントが引き続き Python を記述できます。

AI トークンとは、モデルが読み書きするテキストの単位です。生成するコードを減らすことで AI の利用を抑えられますが、合計トークン数、コスト、所要時間はモデルやタスクによっても異なります。シーンのチェックは正確性の向上に役立ちますが、美しい仕上がりやエラーのない結果を保証するものではありません。

1 つの参照画像、2 つの Blender ワークフロー

ViperMesh Blender MCP ハーネスと利用可能なアセットを使った、歴史的な画像再構築テストです。中央の見出しのみを付け替えており、参照画像と両方のシーンのスクリーンショットに変更はありません。これは一例であり、毎回同じ結果になることを保証するものではありません。公開アドオンには、非公開の Studio アセットライブラリは含まれていません。

Blender MCP のケーススタディ、パート 1 を読む | 比較画像を実寸で開く | 画像の整合性記録

どのようなことに役立ちますか？

• シーン内のオブジェクトを作成、移動、複製、配置できます。
• エッジを滑らかにし、マテリアルを調整し、カメラを設定し、ライティングを変更できます。
• オブジェクトが支持物の上に置かれているか、十分なスペースが確保されているかを確認できます。
• メッシュのクリーンアップ、リトポロジー、UV の準備、リギング、ウェイト設定を支援します。
• アニメーション設定の操作、エクスポートの準備、結果の確認ができます。

たとえば、アシスタントに次のように依頼できます。

バスケットをテーブルの右側の下に移動し、脚と交差しないようにしてください。

家具の全体的な形状は保ったまま、鋭いエッジを滑らかにしてください。

このシーンで支持されていないオブジェクトを確認し、修正が必要な箇所を表示してください。

これらは依頼の例であり、あらかじめ用意されたシーンテンプレートではありません。ツールで対応できる操作について、Blender Python を自分で書く必要はありません。

元の BlenderMCP とは何が違いますか？

ViperMesh は、現在 MCP for Blender という名前になっている、Siddharth Ahuja による元の BlenderMCP プロジェクトを基にしています。主な違いは、よくある編集で新たに生成した Python に頼るのではなく、すぐに使える幅広い編集アクション、再利用可能なワークフロー、シーンチェックを重視している点です。

どちらのプロジェクトもシーンを確認し、カスタム Python を実行できます。元のプロジェクトには、アセットや生成機能との連携もあります。ViperMesh は、日常的なシーン操作をトークン効率よく、より速く、アシスタントがより簡単に使え、検証しやすくすることを目指しています。すべてのタスクで優れている、あるいは公開コネクターに ViperMesh Studio のすべての機能が含まれていると主張するものではありません。

ウェブサイトのインストールガイド · Harness Library の掲載ページ

要件

• 現在テスト対象としているリリースには Blender 5.2
• Node.js 20 以降
• stdio サーバーに対応した MCP 互換クライアント

MCP は Model Context Protocol の略で、AI アシスタントが別のアプリケーション内のツールを使えるようにする接続規格です。こうした接続に対応した AI アプリが必要です。アドオンをインストールしただけでは、Blender に AI モデルは追加されません。

インストール

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

バージョン付きのアドオン .py またはアドオン .zip を 最新リリースからダウンロードします。Blender で次の手順を行います。

1. Edit > Preferences > Add-ons を開きます。
2. Install from Disk を選択し、ダウンロードした Python ファイルを選びます。
3. ViperMesh for Blender を有効にします。
4. 3D ビューポートのサイドバーを開き、ViperMesh を選択して、 Start Local Bridge をクリックします。

エージェントのセッションが終了するまで、ブリッジを起動したままにしてください。

2. MCP サーバーをインストールする

パッケージ版：
v1.3.0 MCPB バンドルをダウンロードし、ローカル MCPB 拡張機能に対応したクライアントにインポートします。Node サーバーとその依存関係が含まれているため、リポジトリをクローンしたりビルドしたりする必要はありません。Node.js と、別途有効化する Blender アドオンは引き続き必要です。

このコネクターは、Smitheryおよび公式 MCP Registryにも掲載されています。これらの掲載先で配布されるのはローカルコネクターであり、ホスト型の Blender サービスではありません。チェックサム、手動での展開方法、現在の検証上の制限については、配布とバンドルのセットアップを参照してください。

ソース版： npm パッケージが公開されるまでは、クローンしてビルドしてください。

git clone https://github.com/OpenRootdev/vipermesh-blender.git
cd vipermesh-blender
npm install
npm run build

3. AI アシスタントを接続する

MCPB をインポートする場合、クライアントはバンドルから起動設定を読み込みます。ソース版の場合は、ビルド済みのエントリーポイントを絶対パスで指定してください。

{
  "mcpServers": {
    "vipermesh-blender": {
      "command": "node",
      "args": [
        "C:/absolute/path/to/vipermesh-blender/dist/public-portable-blender-mcp.js"
      ]
    }
  }
}

このコマンドは、MCP クライアント経由で一度だけ起動します。Blender の操作ごとに npm、npx、または tsx を再度実行しないでください。Codex、JSON 設定クライアント、互換性、オプションの Docker MCP Toolkit 経由の方法については、MCP クライアントのセットアップを参照してください。

技術詳細

以下のセクションは、AI 接続のセットアップまたは開発向けです。Blender ユーザーは、インストール手順と上記のリクエスト例から始められます。

接続モデル

MCP-compatible AI assistant
        |
        | stdio, one long-lived process
        v
ViperMesh MCP server
        |
        | serialized loopback connection
        v
ViperMesh Blender addon (127.0.0.1:9876)
        |
        v
Blender scene

MCP サーバーはネットワークリスナーを開きません。Blender アドオンはデフォルトでループバックをリッスンし、ViperMesh サイドバーに 停止、準備完了、エージェント接続済み、または エラー と表示します。

エージェントによる最初の呼び出し

1. bootstrap_vipermesh_session を呼び出します。
2. call_blender_tool(name="get_scene_info") でシーンを確認します。
3. search_3d_guidance でタスクのガイダンスを検索します。
4. list_blender_tools で関連する機能だけを見つけます。
5. 作成し、確認・修正してから、最終処理を行って保存します。

公開 MCP インターフェースには、以下が含まれます。

• bootstrap_vipermesh_session
• check_blender_connection
• list_blender_tools
• call_blender_tool
• call_blender_tool_batch
• run_blender_scene_stage
• get_blender_agent_context
• search_3d_guidance
• get_3d_guidance_document

リクエストの形式、バッチ処理のルール、段階的なワークフロー、ローカルツールのスキル、トラブルシューティングについては、コネクターの完全マニュアルをお読みください。リポジトリには、インストール可能なusing-vipermesh-blender エージェントスキルも含まれています。

セキュリティ

このコネクターは、信頼できるローカルワークステーションでの使用を想定しています。execute_code は Blender 内で任意の Python コードを実行できます。信頼できる MCP クライアントのみを接続し、ブリッジをループバックに設定したままにし、影響の大きい操作や破壊的な操作は確認してください。

信頼境界と非公開の脆弱性報告手順については、SECURITY.mdを参照してください。

公開コネクターの範囲

このリポジトリには、オープンソースの Blender アドオン、ポータブル MCP サーバー、ポータブルな公開ツールスキル、コネクターのテストが含まれています。ViperMesh アプリケーション、認証、課金、非公開のプロンプト、非公開の RAG データ、クラウドモデルのルーティング、非公開アセット、未加工のベンチマーク記録、非公開の評価データセットは含まれていません。図示された比較は別途提供される公開証拠であり、同梱のアセットライブラリではありません。

このコネクターには、商用の 3D 生成プロバイダーは同梱されていません。ニューラル生成は、サードパーティーの認証情報を Blender に埋め込むことなく、プロバイダーに依存しない認証済みサービスを通じて、後から追加できます。

よくある質問

有料の ViperMesh アカウントは必要ですか？

いいえ。公開アドオンとローカル接続は、ViperMesh アカウントがなくても無料で使用できます。AI アプリまたはモデルプロバイダーには、別途料金が発生する場合があります。アドオンには、無料の AI モデルへのアクセスは含まれていません。

プログラマーである必要がありますか？

対象となる Blender の編集で Python を記述する必要はありません。初期設定では、アドオンのインストールと、互換性のある AI アプリの接続が必要です。MCPB バンドルに対応したクライアントではそれを使用するか、提供されているコマンドを使ってソースからビルドしてください。Blender ブリッジとクライアントの設定をそれぞれ有効にする必要があるため、すべての環境でワンクリックインストールできるわけではありません。

ViperMesh は execute_code を置き換えますか？

いいえ。構造化された操作を提供することで、不要な Blender Python の生成を減らしますが、カスタムジオメトリ、プロシージャルエフェクト、一般的でないノードグラフ、未対応のワークフローには execute_code を引き続き使用できます。

MCP プロセスを実行したままにする必要があるのはなぜですか？

このプロセスは Blender へのシリアライズされた接続を保持します。呼び出しごとに再起動すると、回避可能な起動、トランスポート、エージェントツールのオーバーヘッドが発生します。

Docker は必要ですか？

いいえ。ローカルの stdio 対応 MCP クライアントは Node サーバーを直接起動します。Docker MCP Toolkit は任意のパッケージングおよびゲートウェイ経由の方法であり、ホストから Blender へのループバック接続についてクロスプラットフォームでの検証がまだ必要なため、現時点では ViperMesh のサポート対象インストール方法ではありません。

公開コネクターを利用するには ViperMesh のクラウド認証が必要ですか？

いいえ。公開アドオンとローカル MCP サーバーは、ViperMesh の認証なしで動作します。将来提供されるホスト型モデルと独自のオーケストレーションは、別個の製品機能です。

インストール済みの Blender アドオンを使用できますか？

コネクターはインストール済みアドオンを調査でき、信頼できるローカル自動化をサポートします。不明なアドオンの操作をエージェントから呼び出せる機能として公開する前に、内容を確認してください。

開発

npm install
npm run check
python -m py_compile addon/vipermesh-addon.py

プルリクエストを作成する前に、CONTRIBUTING.md をご覧ください。

ライセンスと帰属表示

Blender 用 ViperMesh は MIT License のもとで公開されています。BlenderMCP から派生した成果物が含まれています。作成者は Siddharth Ahuja です。帰属表示と商標に関する通知については、NOTICE.md をご覧ください。