Skip to main content
Glama

Roxy Blender MCP

LLM(Claude など)から Blender を操作して、公式 Blender MCP より高品質なモデルを作るための MCP サーバーです。 公式 MCP の機能(Python 実行・画像確認・アセットライブラリ)を含みます。AI による 3D 生成機能は意図的に入れていません。

公式 MCP は「LLM が生の bpy コードを書いて実行し、画像で確認する」設計なので、仕上がりは LLM の書き方次第です。 Roxy は品質のノウハウを ツール側に組み込んで あります。LLM が普通に呼ぶだけで、プロのモデラーの定石が適用されます。 具体的には、実寸モデリング、ベベル、法線処理、PBR マテリアル、照明の較正、品質チェック、取り込みモデルの正規化です。

公式 MCP との違い

公式 MCP for Blender

Roxy Blender MCP

モデリング

生 Python(execute_blender_code)

回転体・押し出し・スイープ・ロフト・管・プリミティブ・メッシュ編集の高レベルツール(Python も併用可)。穴付きパネルは制約付き三角形分割で生成し、縁の巻き込み・膨らみを形状として作る

サイズ

LLM 任せ(スケールで伸ばしがち → ベベルが歪む)

すべて実寸のメッシュで生成、スケール 1 のまま

エッジ

何もしなければ鋭角のまま(CG っぽさの主因)

bevel= で角度制限ベベル+法線ハードニング+自動スムーズ

曲面

自前で頂点計算

制御点数個からスプライン補間、60°以上の折れ点は自動で角に(底が膨らまない)

配置

座標を手計算

place_object(on_top / left_of …)でバウンディングボックス基準に正確に接地

モディファイア

自前で設定

品質デフォルト付き+スタック自動整列(Boolean/Mirror → Bevel → Subdivision → Weighted Normal)

マテリアル

基本色のみになりがち・sRGB/リニア混同

Poly Haven に実写スキャンがある素材はすべて実写を自動使用(木・合板・古材・コンクリート・石・レンガ・漆喰・粘土・布・ベルベット・革・樹皮・錆・縞鋼板など。色指定は写真のまま色味を調整、polyhaven='苔むした岩' のような言葉で任意の Poly Haven テクスチャも選択可、木目は部材の長手方向に自動で揃う)。Poly Haven にスキャンが存在しない素材(鏡面・有色金属、ガラス、樹脂、磁器、塗装、大理石・御影石)とオフライン時のみ手続き版の 58 種プリセット(UV 不要・実寸スケール・部品ごとの個体差)。木は年輪と導管で板目/木口を再現、大理石の網目状の脈、数 mm の鉱物粒の御影石、実寸レンガ、指紋や拭き跡のある金属、フレーク入り車塗装、糸単位の織り目の布、シボ・シワのある革など。sRGB→リニア自動変換

照明

自前

AgX 前提で露出較正済みの 8 プリセット、被写体サイズに自動スケール

確認

ビューポート / 多視点 / アニメーション

同等以上: 正投影(実寸幅表示)+パースの多視点シート、ワイヤーフレーム・クレイ・X線・マテリアル表示、アニメーションのコマ送り、任意画像の表示

AAA 仕上げ

—

使用感レイヤー(擦れ・汚れ・ほこり・錆・経年・苔・雪・濡れ・擦り傷。Blender上でスライダー調整可)、PBR値の自動補正、板張り add_planks・レンガ/石積み/タイル add_masonry・角の欠け add_damage(ジオメトリーノード、つまみ付き)、参考画像との形の照合 compare_reference、自然な散布 scatter(小石・瓦礫・葉)、ディテール一発追加(分割溝・ネジ・リベット・通気スリット)、クッション生成(パイピング・房付き)、AAA 基準の自己採点 review_model(優先順の修正リスト付き)

品質チェック

メッシュ/ウェイトの健全性

浮き・めり込み・法線反転・内部面・重複頂点・ファセット・未ベベル・スケール未適用・ウェイト漏れなどを検出し、修正方法を提示

取り込み物の後処理

サイズ指定程度

実寸化・接地・スケール 1・原点を底面中央に・余計なカメラ/ライト除去・重複頂点/スムーズ修正・ポリゴン予算・テクスチャ埋め込み・クレジット記録・自動プレビュー

ブロックアウト連携

—

Roxy で作った大まかな形を、取り込んだモデルで同じサイズ・位置に差し替え(fit_to)

アセット

Poly Haven / Sketchfab / Poly Pizza

同じ 3 ライブラリ+Sketchfab はキーなしで検索可、Poly Haven テクスチャは実寸スケールで UV 不要の貼り付け、.blend の非表示の残骸を除外

アニメーション・リグ

—

キーごとのイージング(AE の Easy Ease・影響度%、CSS cubic-bezier、back/bounce/elastic)、予備動作・行き過ぎ付きの定番プリセット(開く・閉じる・引き出し・回転・揺れ)、小物の蝶番リグ(開く向き自動判定・可動範囲)、完成キャラへの自動リグ(UE5 Mannequin 互換の骨名・指・ねじれ骨・IK骨、服と髪も自動ウェイト、ポーズ検査)、UE5 用 SK_/A_ FBX 書き出し

ゲームアセット化(UE5)

—

make_game_asset 一発で、ハイポリ→ローポリ(誤差0.1%以内のリトポロジー、ネジ等の小部品・ベベル・欠け・板の隙間は法線マップへ、面積加重法線)、AAA 手法の自動 UV(硬い角と見えない場所に継ぎ目、帯の直線化、1024px/m、ライトマップUV)、焼き漏れの自動検査、Blender 専用の質感(Poly Haven・手続き・使用感)を部品ごとに Cycles で焼き付け、BaseColor / Normal(DirectX)/ ORM の PNG、ガラスは別スロット、UCX_ 当たり判定、SM_ 命名・底面中央ピボットの FBX まで。review_model(purpose='game') でゲーム基準チェック

ファイル入出力

—

ローカルの glb/gltf/fbx/obj/stl/ply/usd/abc/blend 取り込み、glb/fbx/obj/stl/ply/usd(z) 書き出し(ゲームエンジン・AR・3D プリント)

安全策

—

チェックポイント保存/復元、GUI では 1 コマンド = 1 アンドゥ

ノウハウ

—

実寸表、ハードサーフェス、オーガニック、家具、プロダクト、マテリアル、照明、アセット活用のガイドと検証済みレシピ

テレメトリ

あり(オプトアウト式)

なし

Related MCP server: Blender MCP Server

構成

Claude ──(MCP stdio)──> roxy-blender-mcp (src/roxy_blender_mcp) ──(TCP 127.0.0.1:9877)──> Blender アドオン (addon/roxy_blender_bridge)
                              │
                              └── HTTPS: Poly Haven / Sketchfab / Poly Pizza(ダウンロードはキャッシュに保存)
  • Blender アドオン: Blender 内でソケットサーバーを起動し、すべての処理をメインスレッド(タイマー)で実行します。 モデリング・取り込み後処理のロジックはここにあります。ネットワーク通信はしません。

  • MCP サーバー: ツール定義(LLM 向けの説明文)、アセットライブラリとの通信、ガイド配信を担当します。

  • 公式 MCP(ポート 9876)と同時に使えます。

セットアップ

必要なもの: Blender 4.2 以降(5.1 で検証)、uv

  1. アドオンのインストール(Blender を閉じた状態で)

    python3 scripts/install_addon.py          # シンボリックリンクで導入し有効化
    python3 scripts/install_addon.py --uninstall

    Blender を起動すると自動でブリッジが立ち上がります(3D ビュー右サイドバーの「Roxy」タブで状態確認・開始/停止)。

  2. Claude Code に登録

    • このフォルダで使う場合: 同梱の .mcp.json が読み込まれます。

    • どこからでも使う場合:

      claude mcp add roxy-blender -s user -- uv run --directory "/path/to/Roxy-Blender-MCP" roxy-blender-mcp
  3. (任意)アセットライブラリの API キー(Poly Haven はキー不要。Sketchfab のダウンロードと Poly Pizza のみ)

    uv run roxy-blender-mcp configure     # または環境変数 SKETCHFAB_API_TOKEN / POLYPIZZA_API_KEY
  4. GUI なしで使う場合(任意): scripts/run_headless_blender.sh [--port 9877] [file.blend]

使い方

Claude に普通に頼むだけです。例:

  • 「北欧風のダイニングチェアをモデリングして、プロダクト撮影風にレンダリングして」

  • 「リビングを作って。ソファと観葉植物は Poly Haven から、ローテーブルはモデリングで」

  • 「この椅子を GLB で書き出して」

MCP プロンプト model_object は、品質ワークフロー(計画 → 実寸ブロックアウト → 構造・接合部の詳細化 → 表面仕上げ → 品質チェック → 全体・寄りの画像確認 → レンダリング)を指示します。 標準の制作指示は、対象や用途を問わず、全モデル・全部品を接写に耐える精密さで作り込むよう促します。 キャラクター・自然物・衣服・機械・家具・建築・小物に共通して適用し、背景用という理由だけでは省略しません。 簡略化は、ラフ・低詳細・ポリゴン予算などをユーザーが明示した場合に限ります。 地域の指定がなければ、日本で一般的な形状・寸法・構造・部品・生活用品・植生を基準にし、看板やラベルも日本語を基本にします。 日本基準は厳格な制作要件です。輸入アセットや背景の部品にも適用し、海外仕様や汎用寸法での代用を禁止する指示を入れています。 get_guide('japan') に従い、地域依存の細部は日本の参考資料を確認してから作ります。 不明・不確かな点はまず AI クライアントの検索・ブラウザでメーカー資料や公式情報を調べ、調査でも解決できない場合や調査手段がない場合に限って質問します。 Roxy 自体には汎用 Web 検索ツールはなく、接続する AI 側の調査ツールを使う指示です。 未確認の箇所は未完成として報告し、納品前に日本仕様との一致を画像で確認します。自動の形状判定・強制機能ではありません。 現代の題材には現代日本の例を使い、伝統的な意匠は題材に合わせて選びます。明示された国・様式・固有の対象・参考画像を優先します。 get_guide('detailing') には、肉厚・継ぎ目・取り付け部の設計、形状とバンプの使い分け、部位ごとの確認手順をまとめています。 指示とガイドによる改善なので、完成度は実際のモデルと画像で確認します。

modeling_progress は部位ごとに「参照資料 → 形状 → 構造 → 細部 → 材質 → 最終確認」を記録するツールです。 最初に define_features で部位の特徴的な輪郭・開口・接続先を整理し、資料の出典、保存した参照画像、対象オブジェクト、確認ビューを登録します。実物の写真や図面を使い、ペーパークラフト・模型の簡略化を形状根拠にしません。 compare_features では接写で観察した形と資料との差異を記録します。不合格から合格にするには、record_revision に実際の修正または誤った観察を訂正する根拠を残し、新しい画像で再確認する必要があります。未修正の特徴、未解決の資料、前工程を飛ばした合格は完成判定を通しません。 inspect_connections は配管・連結棒などの指定した端点と接続先の評価済み形状との距離を測ります。穴を含む実際の表面を使い、端点が部品自身の表面にあるかも検査します。特徴に connection_checks を登録すると、合格の記録時にも自動で測定し、隙間が許容値を超えていれば合格を拒否します。ジョイント中心同士の検査も可能です。接続相手の正しさ、干渉、機構の動作は別途確認します。 登録した対象の形状・材質入力と画像を指紋で追跡し、確認後の変更や根拠画像の消失で完成判定を止めます。invalidate で後続工程と全体の最終確認を戻せます。記録は .blend に保存されるため、根拠画像も制作フォルダに保存してください。 画像の内容を自動理解する機能ではありません。未登録の部品、外部テクスチャや入れ子のシェーダーなど全依存関係の変更検出は保証しません。AI が実際の資料と接写を比較する必要があります。旧バージョンの進捗記録にも特徴の登録・確認が必要です。詳しい制作例は get_guide('reference_fidelity') にあります。

ツール一覧(58)

分類

ツール

確認

get_status, get_scene_info, inspect_object, look, viewport_screenshot

形状作成

create_primitive, create_lathe, create_extrusion(穴・縁の巻き込み・プレスの膨らみ), create_sweep, create_loft(断面の上下非対称・丸い端・ねじれない対応), create_pipe(太さが連続的に変わる管・曲げ半径・肉厚), create_text

編集

edit_mesh, add_modifier, manage_modifiers

配置・整理

transform_object, place_object, duplicate_pattern, organize_objects, clear_scene

マテリアル

apply_material, list_material_presets, uv_unwrap, uv_report

演出

setup_lighting, create_backdrop, setup_camera, render_image

アセット・入出力

search_assets, import_asset, import_model_file, export_model

AAA 仕上げ

add_surface_detail, add_planks, add_masonry, add_damage, create_cushion, review_model, compare_reference, scatter

ゲームアセット

make_game_asset

アニメーション・リグ

animate, animate_preset, check_animation, rig_prop, rig_character, export_skeletal

品質

analyze_quality, cleanup_mesh, modeling_progress, inspect_connections, check_contacts(どこにも付いていない部品・宙で終わるケーブルやステーの端を実表面で検出。床に立つ部品は接地扱い), attach_part(隙間を閉じる:移動・方向指定移動・端の延長・表面への沿わせ。別部品へのめり込みが生じる移動は取り消して拒否), declare_free(意図的に開いた端・独立した付属品を理由付きで宣言)

安全策・拡張

checkpoint, execute_python, batch, get_guide

ガイド(get_guide / guide:// リソース): workflow, dimensions, hard_surface, organic, furniture, product, detailing, reference_fidelity, japan, materials, lighting_render, assets, game_assets, animation_rigging, recipes, troubleshooting

テスト

B=/Applications/Blender.app/Contents/MacOS/Blender
$B --background --factory-startup --python tests/blender_progress_test.py                 # 部位別進捗・保存
$B --background --factory-startup --python tests/blender_fidelity_test.py                 # 修正・再確認・接続の検査
uv run python tests/e2e_fidelity_test.py                                                  # 新しい手順を MCP 経由で検証
$B --background --factory-startup --python tests/blender_commands_test.py -- /tmp/roxy_out   # 全モデリングコマンド
$B --background --factory-startup --python tests/blender_recipes_test.py -- /tmp/roxy_out    # レシピ 6 種を実行・レンダー
$B --background --factory-startup --python tests/blender_import_test.py -- /tmp/roxy_out     # 取り込み後処理・書き出し
uv run python tests/e2e_mcp_test.py [--gui]       # MCP クライアント → サーバー → Blender
uv run python tests/e2e_assets_test.py            # アセットライブラリ(Sketchfab/Poly Pizza はモック、Poly Haven は本番 API)

tests/mock_services.py は Sketchfab / Poly Pizza の API 仕様どおりに応答するモックです(キーなしで実装経路を検証)。

新規モデリング比較

比較の記録(画像・モデル・評価資料・参考写真)は、第三者の写真や比較先のコードを含むためこのリポジトリには含めていません。bench/ には再現用のスクリプトのみがあります。

強化後の再比較では、別題材の 1969 ホンダ CB750 FOUR K0 を、同じHonda実車資料・25分上限で設計から独立に新規制作しました。MCP名を伏せた固定8項目(各0〜4)のアシスタント評価は、比較先17/32、Roxy14/32です。Roxyの品質優位は出ていません。サイドカバーの面割れ・タンク下部の凹凸・マフラー形状に相違が残りました。比較先の自己レンダー中断・復旧時間も制作枠に含めています。Roxyの完成判定は未通過です。単一試行であり、前のC62とは題材が違うため改善率は計算しません。

共通撮影の再現: Blender --background --factory-startup --python bench/cb750_render.py -- official と同じコマンドの roxy、その後 python3 bench/prepare_cb750_review.py。匿名評価後に python3 bench/plot_cb750_comparison.py。原本・入力・MCPコードの保持確認は uv run python bench/audit_cb750_trial.py。

以下は強化前の比較です。

前回の比較では、C62形2号機を設計から独立に制作しています。同じ実車写真・博物館の寸法・制作時間枠を別文脈の制作担当へ渡し、共通の組立設計や前回のモデルを使用しません。Roxy側は比較実施時点の指示・プロンプト・ガイド・ツール、比較側はahujasid版の指示・ツールを使用します。完成物を共通撮影し、MCP名を伏せた別担当の写真照合で評価します。特徴比較・修正履歴・接続の測定ゲートを追加する前の結果であり、今回の強化後の品質を示す比較ではありません。

これは単一題材・各1試行のアシスタント評価で、統計的な優位やAAA品質の認定ではありません。部品数・三角形数を品質点に換算しません。以下は以前の共通設計による制作経路比較です。

さらに複雑な題材として、C62形2号機の実車写真と京都鉄道博物館の寸法資料を参考に、機関車・炭水車1,747部品と線路303部品を新規制作しました。動輪の実開口、連結棒・ピストンの連動、配管、葉ばね、運転室、炭水車を含みます。ペーパークラフトや模型は形状の参考にしません。

再現: uv run python bench/live_c62_compare.py、続けて matplotlib / Pillow のある環境で python3 bench/plot_c62_comparison.py。

より複雑な題材として、日本信号 GX-7 の国内資料を参考にした自動改札機2台を両MCPで新規制作しました。394部品で、曲面筐体、券口の実際の切り込み、IC読取部、表示器、保守扉、ネジと溝、センサ、換気スリット、開閉するフラップを含みます。材質はそれぞれの制作経路で作り、撮影条件と実測だけを共通にしました。部品数・三角形数は品質点ではありません。

再現: uv run python bench/live_gate_compare.py、必要に応じて Blender --background --python bench/audit_gate_views.py で単色ビューを再描画し、続けて matplotlib / Pillow のある環境で python3 bench/plot_gate_comparison.py。Blenderの起動時ダイアログがある場合は新規起動を選びます。これは同じ担当者による同仕様の制作経路比較で、AIの独立した自律制作能力やAAA品質の認定ではありません。比較先は ahujasid 版で、Blender Foundation公式MCPではありません。

2026-10-07 に、日本の一合枡を現在の Roxy と ahujasid 版 MCP for Blender の実際のサーバー経由で新規制作しました。 同じ設計・材質・撮影条件では、幾何チェックは双方 7/7、独自スコアは双方 80、三角形数は比較対象 6,316 / Roxy 7,212 でした。 この1課題から品質優位や AAA 品質達成は結論できません。AI の独立した自由制作比較ではなく、同じアシスタントが制作コードを作る比較です。

古い宝箱のグラフは異なる制作レシピを Roxy 経由で実行した保存結果で、今回の同仕様・実サーバー比較とは条件が異なります。

レンダー・プレビュー・チェックポイントは OS の一時フォルダの roxy_blender_mcp/ に保存されます(get_status の work_dir)。ダウンロードは ~/Library/Caches/roxy-blender-mcp/ にキャッシュされます。

ライセンス

GPL-3.0-or-later(Blender アドオンの要件に合わせています)。取り込んだアセットのライセンスは各提供元に従います (CC-BY はクレジット表記が必要。オブジェクトのカスタムプロパティ roxy_license / roxy_author に記録されます)。

Available Tools

58 tools
add_damageA

Real chipped edges (wood, stone, concrete, painted props): flakes sliced off convex edges as geometry, rims softened by the bevel, wear shading follows the chips. Live Geometry Nodes modifier 'Roxy Damage' (editable sliders). make_game_asset bakes it into the normal map. Not for clean new products.

Inputs: objects (required), seed, size, depth, +3 more.

add_masonryA

Real bricks, blocks, stone courses or tiles cut from a solid (walls, chimneys, floors, steps): joints are real gaps with a mortar bed behind, every unit varies in depth and tone. Live Geometry Nodes modifier 'Roxy Masonry' (sliders) + a '_Mortar' child. add_damage chips the arrises; make_game_asset bakes it.

Inputs: objects (required), up, seed, along, +7 more.

add_modifierB

Add a modifier with quality defaults (exact booleans with the cutter hidden, even-thickness solidify, clipped mirror, angle-limited bevel with hardened normals). The stack is auto-ordered so booleans/mirror/ solidify run before bevel and subdivision.

Inputs: type (required), object (required), name, apply, +1 more.

add_planksA

Turn a solid (box, lid, extrusion) into real boards/staves with gaps - crates, chests, floors, fences, barrels, doors. Live Geometry Nodes modifier 'Roxy Planks' (editable sliders); every board gets its own 'roxy_board' value so wood materials vary in tone per board. Bevel/chips/weathering apply per board. make_game_asset bakes the gaps into the normal map (the game mesh stays a clean solid).

Inputs: objects (required), gap, axis, seed, +2 more.

add_surface_detailA

Secondary detail is what makes hard-surface models read as manufactured: seams, fasteners, vents. Screws/rivets are snapped onto the actual surface and parented to the object; panel lines are real grooves (bevelled by the object's bevel modifier); vents are a live boolean.

Inputs: kind (required), object (required), axis, rows, +10 more.

analyze_qualityB

Find what makes a model look wrong: floating or sunken parts, flipped normals, non-manifold/internal faces, duplicate verts, faceted shading, razor-sharp unbeveled edges, unapplied scale, missing materials, intersecting parts, missing camera/lights. Each issue comes with a fix hint.

Inputs: objects, ground_z, check_intersections.

animateC

Keyframes with designer-grade easing per segment (After Effects Easy Ease, CSS cubic-bezier, back/bounce/ elastic). Returns a curve check (speed spikes, loop seams).

Inputs: object (required), bone, keys, loop, +3 more.

animate_presetB

Prop motions with the principles of animation built in - the quickest way to a lively lid, door, drawer, lever, fan or pickup. Each preset becomes its own action (clip).

Inputs: object (required), axis, bone, ease, +8 more.

apply_materialB

Physically based materials with procedural detail (grain, veins, micro-roughness, bump) and optional weathering, no UVs needed. Identical specs are shared automatically. Prefer presets over plain colours; real objects mix materials (wooden top + metal legs, ceramic body + cork lid).

Inputs: objects (required), wet, bump, dirt, +23 more.

attach_partB

Close the gaps check_contacts measured, using the measured closest points (no guessed coordinates).

Inputs: objects (required), end, gap, mode, +4 more.

batchA

Run many tool calls in one round-trip (e.g. all the parts of a chair). Results come back per step. Not for look/render_image (their images are dropped).

Inputs: operations (required), stop_on_error.

check_animationB

Find sudden speed changes and loop seams (hitches) in animation curves.

Inputs: objects.

check_contactsA

Which parts really touch (evaluated surfaces, embedded parts count), every part or group detached from the main assembly with its gap and nearest assembly part, and elongated parts with loose ends. Bounding-box checks miss these in dense models. Touching is not proof of the right mount - check the real partner.

Inputs: objects, tolerance, check_ends.

checkpointB

Snapshot the scene before risky edits and roll back if they go wrong (restore replaces the current scene's objects with the snapshot; the user's .blend file is untouched).

Inputs: name, action.

cleanup_meshB

Merge duplicate verts, remove loose geometry and degenerate faces, make normals consistent.

Inputs: objects, shading, remove_loose, merge_distance, +2 more.

clear_sceneB

Delete every object in the scene (start fresh). Ask the user first if the scene has their work.

Inputs: keep_camera, keep_lights.

compare_referenceA

Compare the model's silhouette with a reference photo/concept: proportions only (both normalised to their height). Returns IoU, overall aspect difference and per-height corrections ('at 70-80 % height the model is 18 % narrower', with world z), plus an overlay image (red = only in reference, blue = only in model). Fix the listed bands (edit_mesh scale/soft_move on that z range) and compare again. Use corresponding reference/model views and separable backgrounds. Normalized silhouette agreement cannot verify absolute dimensions, apertures, attachments, materials or AAA fidelity.

Inputs: image (required), view, bands, objects.

create_backdropC

Seamless studio backdrop or floor sized to the subject, sitting at its lowest point.

Inputs: size, color, style, target, +1 more.

create_cushionB

Upholstered soft goods built like the real thing (rounded-rectangle plan, bulging sides, crowned faces, seam piping, optional buttons). Origin at the bottom centre; returns top_z for stacking.

Inputs: size (required), name, bulge, crown, +9 more.

create_extrusionA

Extrude a 2D outline into a solid with clean quad sides - for anything defined by a silhouette: chair/shelf side panels, brackets, plates with holes, table aprons, logos, gears, cookie-cutter shapes. Draw in the plane you think in (front elevation = XZ). Holes, rolled rims and crowns are built as a well-formed surface (even triangles, real quarter-round rims): give the shape here instead of adding a big Bevel or pushing vertices afterwards. Holes must lie inside the outline (checked).

Inputs: points (required), back, name, bevel, +20 more.

create_latheB

Surface of revolution around the local Z axis - the best tool for anything round: bottles, vases, cups, bowls, lamp bases, knobs, wheels, columns, chess pieces, light bulbs. Example vase: profile=[[0,0],[0.06,0],[0.09,0.06],[0.1,0.13],[0.05,0.24],[0.04,0.28],[0.05,0.3]], cap=false, thickness=0.004.

Inputs: profile (required), cap, name, angle, +15 more.

create_loftB

Skin a smooth surface through cross-sections - for forms whose section changes along their length: fuel tanks, seats, square-to-round bottles, hulls, fuselages, vehicle bodies, trunks, organic product shells.

Inputs: sections (required), caps, name, bevel, +14 more.

create_pipeB

One continuous tube whose radius changes along a curved path - exhaust header + reducer + muffler in one piece, horns, bottle necks, hoses with sleeves, branches. No separate cylinders butted together.

Inputs: path (required), caps, name, wall, +9 more.

create_primitiveA

Create a primitive built at its TRUE size (mesh data, scale stays 1, so bevels stay even). Returns its world bounding box so you can place the next part precisely.

Inputs: type (required), name, size, bevel, +15 more.

create_sweepB

Sweep a profile along a 3D path: mug/bag/door handles, pipes, cables, hoses, bent tubular chair frames, picture frames (closed + rect), rails, springs, horns (taper).

Inputs: path (required), caps, name, bevel, +13 more.

create_textC

3D text (converted to a mesh) with beveled edges.

Inputs: text (required), font, name, size, +9 more.

declare_freeA

Record intentional separation so check_contacts and the delivery gate do not flag it.

Inputs: reason (required), objects (required), ends_only.

duplicate_patternC

Repeat an object in a pattern; the original becomes the first item. Legs, spokes, chairs around a table, shelves, bolts, tiles, fence posts.

Inputs: object (required), pattern (required), axis, join, +13 more.

edit_meshC

Edit mesh geometry with world-space selections (no edit-mode needed). Typical: extrude the top of a box into a neck, inset+extrude a panel recess, bevel just the rim of a face, soft_move to sculpt organic forms, loop_cuts before deforming, bisect+clear_outer to keep one half for a mirror modifier.

Inputs: object (required), operation (required), axis, cuts, +26 more.

execute_pythonA

Escape hatch for anything the dedicated tools don't cover (geometry nodes, drivers, particles, custom bmesh work, animation). Prefer the dedicated tools - they carry the quality defaults.

Inputs: code (required).

export_modelC

Export models for other software, game engines, the web, AR or 3D printing.

Inputs: path (required), format, objects, apply_modifiers.

export_skeletalA

UE5 export of a rigged prop: SK_.fbx (skeletal mesh) + A__.fbx per clip, centimetre scale, no leaf bones, root bone 'root'; easing is baked per frame so timing matches exactly.

Inputs: fps, name, actions, armature, +1 more.

get_guideB

Modeling know-how on demand: workflow, dimensions (real-world sizes), hard_surface, organic, furniture, product, detailing (construction, joints, close-up checks), reference_fidelity (feature contracts, repair loops and measured connections), japan (strict Japanese regional policy), materials, lighting_render, assets (libraries and imports), game_assets (UE5 export), animation_rigging (easing, prop rigs, character rigs), recipes (worked examples), troubleshooting.

Inputs: topic.

get_scene_infoA

Scene overview: every object's location, world size, bbox, modifiers, materials, plus camera/lights and the overall model bounding box. Use before editing an existing scene.

Inputs: limit, query, collection.

get_statusA

Blender connection (versions, file, engine, scratch folder) plus which asset libraries are configured. Call it once at the start.

Inputs: no named parameters.

import_assetA

Download an asset found with search_assets and bring it in scene-ready. Models: cleaned, real size, grounded, credited. Textures: a PBR material box-projected at the texture's real-world size (no UVs needed). HDRIs: world lighting.

Inputs: id (required), source (required), name, faces, +16 more.

import_model_fileC

Import a model file from disk with the same clean-up as library assets.

Inputs: path (required), join, name, fit_to, +8 more.

inspect_connectionsA

Measure explicit attachment points against evaluated world-space geometry, including holes and modifiers. Reports gaps or misplaced endpoints that bounding-box checks miss. Tolerances must be justified from the design/scale. This does not discover correct partners, certify photo fidelity, compute signed penetration, sweep collisions or simulate mechanisms. Inspect close-ups too.

Inputs: connections (required).

inspect_objectB

Everything about one object: transform, world bbox, topology (tris/quads/ngons), shading, modifier settings, material slots, UVs, children.

Inputs: name (required).

list_material_presetsB

All material presets with a one-line description.

Inputs: no named parameters.

lookA

See the model: renders several angles into ONE contact-sheet image (orthographic views report their frame width in metres). Call it after every few modeling steps - it is how you catch wrong proportions, gaps and intersections. With frames=[...] it shows an animation over time.

Inputs: size, image, views, frames, +3 more.

make_game_assetA

Turn a finished Roxy model into a UE5-ready game asset: game mesh (low/mid-poly, triangulated, smoothing groups, pivot at bottom centre), UVs at the target texel density, a Cycles bake of EVERY Blender-only effect (Poly Haven projections, procedural recipes, weathering, bevels, small parts) into BaseColor / Normal (DirectX) / ORM (R=AO G=Roughness B=Metallic) PNGs, transparent parts on a separate glass slot, UCX_ collision, and an FBX. Takes 1-4 minutes. Run review_model(objects=['SM_...'], purpose='game') afterwards.

Inputs: lods, mode, name, objects, +7 more.

manage_modifiersB

List / tweak / remove / apply modifiers. Applying a boolean deletes its (hidden) cutter if unused.

Inputs: object (required), name, index, action, +1 more.

modeling_progressA

Scene-persistent per-part completion checklist. Start a plan, inspect each stage and record evidence. Passing requires all earlier stages passed and no unresolved findings. Rechecks invalidate later stages and scene delivery checks (recording delivery itself preserves other delivery checks). After geometry/material/reference changes, invalidate the earliest affected stage before rechecking. report lists blockers; ready_for_delivery means recorded checks passed, NOT certified AAA quality. Define reference shape/attachment features before recording stages. Passing stages requires their comparisons; failed comparisons require recorded repairs and fresh model images before passing. Fingerprints detect changes to declared target geometry, material inputs and saved evidence. No image-content analysis, evidence-truth verification or complete dependency tracking. reset explicitly discards only the checklist, not the model. Stored in the Blender scene and saved with the .blend file. Use one active plan per scene.

Inputs: name, part, parts, stage, +14 more.

organize_objectsC

Housekeeping: rename, delete, duplicate, join meshes, parent, group under an empty (moves as one unit), move to collection, hide/show, select (highlights for the user), shade smooth/flat/auto, set_origin, apply_transform, convert curves/text to mesh.

Inputs: action (required), name, angle, target, +3 more.

place_objectA

Snap an object against another using exact world bounding boxes - no floating cups or sunken legs. e.g. place_object('Lamp', 'on_top', 'Desk', align='keep') keeps its XY and sets its base on the desk.

Inputs: object (required), gap, align, offset, +2 more.

render_imageB

Final render through the scene camera (auto-created if missing) with AgX colour management; returns a preview image and the saved file path. Use cycles for glass/liquids/interiors when quality matters.

Inputs: look, engine, samples, exposure, +5 more.

review_modelA

AAA-standard critique: scores edges, silhouette smoothness, secondary detail, material variety and surface breakup, weathering, integrity (floating/normals) and presentation, and returns prioritised concrete fixes. Run it before declaring a model finished and work down the list.

Inputs: objects, purpose.

rig_characterA

Automatic humanoid rig for a finished character in T- or A-pose (facing -Y, Z up): joints found from the mesh itself, a UE5 Mannequin-compatible skeleton (pelvis, spine_01-05, neck_01/02, head, clavicle, upperarm, lowerarm, hand, fingers, thigh, calf, foot, ball, twist and ik_ bones), weights from a watertight proxy transferred to every mesh (garments smoothed, hair/hats rigid to the head, max 4 influences). Then export_skeletal for UE5 and retarget Mannequin animations with the IK Retargeter.

Inputs: name, fingers, objects, test_poses.

rig_propB

Mechanical rig for props: root bone + one bone per moving part at its hinge, limits, rigid skinning - a UE5-ready skeletal mesh. Children (rivets, handles) follow their parent part.

Inputs: base (required), parts (required), name.

scatterB

Natural scatter (Poisson spacing, random spin/size, aligned to the surface). Live 'Roxy Scatter' modifier; the source items are hidden and kept in a collection for editing.

Inputs: items (required), target (required), seed, sink, +5 more.

search_assetsA

Search ready-made assets. Results carry an id for import_asset, plus licence/author, real-world size (Poly Haven) and face counts.

Inputs: source (required), limit, query, licence, +6 more.

setup_cameraC

Create/aim the scene camera so the subject fills the frame (exact fit to its geometry).

Inputs: dof, view, fstop, margin, +4 more.

setup_lightingA

Replace the lighting with a calibrated rig scaled to the subject (AgX-friendly energies, colour temperatures, HDRI reflections). Run it again any time; previous Roxy lights are removed.

Inputs: hdri, preset, target, rotation, +3 more.

transform_objectC

Move/rotate/resize objects. dimensions= is the safe way to resize (keeps bevels even).

Inputs: objects (required), scale, origin, move_by, +6 more.

uv_reportB

Measure UV quality: islands, packing efficiency (share of the texture used), area stretch, angle error, texel-density spread between islands, seam length and overlaps. Good game UVs: stretch < 3 %, efficiency > 55 %.

Inputs: layer, objects.

uv_unwrapA

UV-unwrap meshes for export/painting (presets and texture_maps work without UVs; make_game_asset unwraps by itself). Returns per-object islands, packing efficiency, stretch and texel-density spread.

Inputs: angle, method, objects, lightmap, +2 more.

viewport_screenshotA

Screenshot of the user's 3D viewport exactly as they see it (GUI Blender only). For judging the model itself prefer look(), which is independent of the user's view.

Inputs: frame, max_size.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 58 tools

    Disambiguation3/5

    With 58 tools, several clusters overlap—quality checks (review_model vs analyze_quality, check_contacts vs inspect_connections), import/export variants (import_asset vs import_model_file, export_model vs export_skeletal vs make_game_asset), and capture tools (look vs viewport_screenshot). The verbose descriptions explicitly distinguish them, but the sheer number and proximity of related operations will still force careful reading to avoid misselection.

    Naming Consistency4/5

    Tool names are overwhelmingly snake_case with verb_noun or noun_verb patterns, and prefixes like create_*, add_*, setup_*, uv_*, rig_*, export_*, import_* are used consistently. A handful of single-word verbs (look, scatter, animate, batch) and noun-first names (viewport_screenshot, modeling_progress) are minor deviations.

    Tool Count1/5

    58 tools far exceeds the typical 3–15 well-scoped range and even the 25+ 'too many' threshold, placing it in extreme mismatch territory for a single MCP server. Although each tool has a specialized role, the cognitive load and selection risk are very high.

    Completeness5/5

    The surface covers the full 3D lifecycle: scene inspection, primitive and advanced mesh creation, editing, modifiers, materials, UV, lighting, camera, rendering, procedural detail, animation, prop/character rigging, game-asset baking/export, asset libraries, and quality analysis. execute_python also acts as an escape hatch, so there are no obvious dead ends.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables Claude AI to directly control Blender for automated 3D modeling, scene creation, and object manipulation. It provides tools for material management, scene inspection, and integration with third-party asset libraries like Poly Haven and Sketchfab.
      10
      2
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI-driven 3D modeling in Blender by providing tools to create primitives, apply modifiers and materials, set up lighting and cameras, capture viewport snapshots, export assets, inspect scenes, and execute Python commands via natural language.
      10
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Enables AI agents to control Blender through 150+ tools across 24 modules, including modeling, materials, lighting, animation, rendering, mesh quality analysis, and visual feedback, plus expert prompts and goal-first workflow management.
      209
      2
      MIT