blender-mcp-ultra
This server is an MCP interface that lets AI assistants control Blender end-to-end, including modeling, materials, animation, rigging, rendering, and durable project workflows.
Modeling: create/transform/duplicate/join objects, add modifiers, mesh editing (subdivide, loop cut, extrude, inset, merge, clean), text, curves, screw/lathe.
Materials: create PBR materials from textures with physical-scale maps, packed ORM/RMA/MRA, normal convention (OpenGL/DirectX), world/UV coordinate space, displacement, micro-surface detail, scratches/grain/dust imperfections.
UV & Baking: unwrap (smart/cube/planar/spherical/cylindrical/seam-based), pack UV islands, measure texel density in pixels/meter, bake Cycles passes to single or multilayer images.
Animation: keyframes, location/rotation/scale animation, actions, interpolation, shape keys, rigid bodies, gravity, render range, clear keyframes, animate from scratch.
Rigging: armatures, bones, mirror bones, IK chains, 20+ constraints, vertex groups/weights, auto-rig, pose reset.
Geometry Nodes: add modifier, add nodes, scatter instances with explicit counts, list modifiers.
Scene & Render: cameras with framing/DOF, three-point lighting, lights, render engine/resolution/samples/Cycles device, render frames, cinematic compositor, HDRI, custom AOVs, multilayer EXR.
IO: export/import scenes and selected objects, list export formats.
Batch/Analysis: batch rename/delete, apply transforms, mesh analysis, scene graph/diff summaries, find objects, check manifold, set dimensions, add wall thickness.
Durable Projects: create/open generation projects with stages, seeds, checkpoints, rollback; register/instantiate reusable components.
Registry Tools: list/describe/call dynamic tools from
src/tools/**;run_batchexecutes sequential operations with rollback attempts (not a full transaction guarantee).
Provides comprehensive MCP tools for controlling Blender, including modeling, coloring, animation, rigging, geometry nodes, UV mapping, rendering, and scene management.
Allows the internal Blender chat assistant to use Google models for natural language command processing.
Allows the internal Blender chat assistant to use locally hosted Ollama models for natural language command processing.
Allows the internal Blender chat assistant to use OpenAI models for natural language command processing.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@blender-mcp-ultra Model a low-poly tree and add a wind animation"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
blender-mcp-ultra
MCP server untuk Blender — pemodelan, material, animasi, proyek bertahap, dan review visual berbasis bukti.
Kendalikan Blender dari asisten AI mana pun (Claude, Cursor, Windsurf, opencode)
lewat Model Context Protocol (MCP), atau dari chat internal Blender dengan LLM
OpenAI-compatible. Tool statis dihasilkan dari spesifikasi mcp_tools.py untuk
FastMCP dan bridge STDIO; katalog registry tambahan memiliki discovery dan
signature sendiri.
Demo End-to-End (LLM Nyata → MCP → Blender Headless)
Demo menggunakan model gpt-6-astra untuk mengendalikan Blender melalui
tool MCP: menyusun scene, mengatur material dan pencahayaan, lalu merender
istana medieval saat sunset.

Satu preview di atas menampilkan hasil render beserta workspace Blender 5.2.0 LTS. Screenshot berasal dari workflow pengguna; bukan sertifikasi bahwa semua tool, jalur headless, atau kualitas visual telah diverifikasi.
Catatan demo headless terdahulu tetap tersedia di DEMO_LLM.md;
model, scene, jumlah aksi, dan lingkungan pada catatan historis tersebut berbeda
dari preview gpt-6-astra ini.
Related MCP server: BlenderMCP
Fitur
Tool MCP statis dari
mcp_tools.py→ FastMCP + STDIO, serta bridge katalog registryAlur "dari nol" per domain:
model_from_scratch,colorize_from_scratch,rig_from_scratch,animate_from_scratchModeling: primitive, modifier, bmesh (bevel/extrude/inset/loop cut/merge), kurva, teks 3D, screw/lathe; dukungan background bergantung operasi dan build
Material: PBR multi-map/packed map, normal OpenGL/DirectX, pemetaan fisik, displacement terbatas, micro-bump dan imperfection terarah
Rigging: armature + bone collections (4.0+), IK chain, 20+ constraint, vertex group/weight, auto-rig, pose reset
Animation: keyframe, animasi loc/rot/scale, action, interpolasi, shape key, rigid body, gravitasi
Geometry Nodes: modifier, node, scatter instance dengan jumlah eksplisit
UV/Printing/Batch/Analysis/IO: unwrap dan packing island, density piksel/meter, bake Cycles, manifold, batch, ringkasan scene, impor/ekspor sesuai format dan build
Proyek persisten: manifest, tahapan macro/meso/micro, checkpoint
.blend, komponen linked ber-anchor, provenance aset, dan review render berulangKamera/Render: framing fisik, HDRI, sky, compositor, render pass dan EXR dengan pelaporan kemampuan engine/build, termasuk perubahan API Blender 5
Keamanan: validasi AST, pelaporan error eksekusi asli, rate limiting
Multi-provider LLM: OpenAI, Anthropic, Google, DeepSeek, OpenRouter, Ollama
Mulai Cepat
Prasyarat
Python 3.10+
Blender 4.2 LTS (atau 5.x) — addon memakai bone collections & EEVEE Next
Klien MCP (Claude Desktop, Cursor, opencode, …)
Pasang addon Blender
# Deteksi otomatis versi Blender, salin paket addon kanonik
python scripts/install.py # Linux/macOS/Windows
# atau pakai ekstensi .blender_manifest.toml langsung di Preferences > Add-onsLalu di Blender: Edit → Preferences → Add-ons → aktifkan "blender-mcp-ultra".
Addon membuka bridge socket TCP :9876; server MCP embedded/SSE :9879 bersifat
opsional dan memerlukan dependensinya. Proses MCP eksternal dapat memakai socket.
Setelah memperbarui salinan addon yang terpasang, restart Blender dan proses MCP/klien MCP agar modul Python dan daftar tool tidak tetap memakai versi lama. Mengedit checkout sumber saja tidak memperbarui addon yang sedang berjalan.
Konfigurasi klien MCP
{
"mcpServers": {
"blender": {
"command": "python",
"args": ["-m", "blender_mcp.server"],
"env": {
"BLENDER_HOST": "localhost",
"BLENDER_PORT": "9876"
}
}
}
}Transport diatur BLENDER_MCP_MODE (stdio default, atau sse untuk :9879).
Uji cepat
pip install -e .
# Suite scene-safe: tidak menjalankan tes integrasi/e2e yang dapat mengubah scene aktif
python -m pytest -q --ignore=tests/e2e --ignore=tests/integration --ignore=tests/test_e2e_socket.py
# Contoh socket berikut MENAMBAH objek/material: gunakan scene uji terpisah, bukan pekerjaan aktif
python - <<'EOF'
from blender_connection import BlenderConnection
c = BlenderConnection(); c.connect()
print(c.send_command("create_object", {"type": "CUBE", "name": "Tes"}))
print(c.send_command("create_material", {"name": "Merah", "color": [1, 0, 0, 1]}))
EOFContoh Tool
Nama tool statis datar (bukan namespace bertitik fiktif); signature-nya ada di
mcp_tools.py. Helper scene/registry tambahan diekspos oleh bridge server:
Domain | Tool |
Modeling |
|
Coloring |
|
Animation |
|
Rigging |
|
Geometry Nodes |
|
Scene/Render |
|
UV/Texture |
|
Batch/Analysis |
|
Printing |
|
IO |
|
Untuk katalog tambahan src/tools/**, panggil list_registry_tools, lalu
describe_registry_tool sebelum call_registry_tool. Nama bertitik yang benar
hanya nama yang dikembalikan katalog; jangan menebak alias untuk tool statis.
Kedua permukaan tidak identik dan tidak semua tool statis ada di registry.
run_batch menjalankan operasi berurutan dengan upaya rollback, bukan jaminan
transaksi yang mengembalikan setiap datablock persis seperti semula.
Alur Material, Detail, dan Review
PBR berskala fisik
validate_texture_set memeriksa file, resolusi dan deklarasi channel sebelum
create_pbr_material_from_textures. Map tersedia untuk base_color, roughness,
metallic, normal, height, ao, opacity, dan emission. Warna/emission
memakai sRGB; map data memakai Non-Color. Packed map mendukung ORM/ARM
(AO=R, roughness=G, metallic=B), RMA, MRA, atau packed_channels eksplisit
untuk role AO/roughness/metallic/height/opacity ke R/G/B/A. Jangan memasok role
yang sama sekaligus melalui map terpisah dan packed map.
normal_conventionharus dinyatakanOPENGLatauDIRECTX; DirectX membalik channel hijau. Tool tidak dapat menebak konvensi dari gambar. Tangent normal memerlukan UV yang sudah ada,coordinate_space="UV", danprojection="FLAT".coordinate_space="WORLD"memakai posisi dunia dantexture_size_mdalam meter, memperhitungkan scene unit scale; hanya proyeksi FLAT/BOX. Tekstur world-anchored: objek bergerak melewati tekstur. Repeat UV sendiri tidak mempunyai ukuran fisik; kalibrasikan UV dengan density yang diukur.displacement_scalepada pembuatan material danscalepadaconfigure_displacementadalah jarak meter. ModeAUTOmelaporkan mode efektif; true displacement perlu dukungan engine/build dan geometri yang cukup. Pembuatan material tidak otomatis menambah subdivision. Konfigurasi displacement membatasi subdivision dan menolak penggantian output displacement yang sudah terhubung kecualireplace_existing=truediminta secara eksplisit.add_micro_surface_detailmemakaiwavelength_mm,amplitude_mm, dan seed deterministik sambil mempertahankan rantai normal. Jika wavelength nol, wavelength efektif adalah1000 / scalemm. Bump tidak mengubah siluet.add_surface_imperfectionsmembuat SCRATCHES/GRAIN terarah atau DUST bermasker permukaan menghadap atas, bukan simulasi keausan;coverageadalah ambang noise, bukan fraksi luas yang dijamin.
Contoh berikut adalah parameter panggilan MCP native tools/call, bukan Python.
Ganti path dan nama objek dengan aset/objek yang benar-benar tersedia; contoh
normal ini memerlukan UV pada Panel:
{
"name": "create_pbr_material_from_textures",
"arguments": {
"material_name": "PanelPBR", "object_name": "Panel",
"base_color": "C:/assets/panel/basecolor.png",
"packed_map": "C:/assets/panel/orm.png", "packed_layout": "ORM",
"normal": "C:/assets/panel/normal_dx.png", "normal_convention": "DIRECTX",
"coordinate_space": "UV", "projection": "FLAT"
}
}UV, density, dan bake
unwrap_object mendukung SMART, CUBE, proyeksi PLANAR/SPHERE/CYLINDER, serta
unwrap berbasis seam ANGLE_BASED/CONFORMAL. SMART dan packing memakai operasi UV
Blender sebenarnya, bukan sekadar normalisasi koordinat. pack_uv_islands
memakai margin sebagai fraksi gambar dan opsi rotasi; konteks objek/mode dipulihkan.
Siapkan seam yang sesuai untuk unwrap berbasis seam.
measure_texel_density dan texel_density memakai piksel per meter berdasarkan
luas segitiga world-space, transform objek, scene units, serta texture_width dan
texture_height. Hasilnya density ekuivalen-luas, bukan jaminan distorsi lokal
nol. Packing dapat mengubah density; ukur ulang sesudah packing. Scaling ke
density tinggi dapat keluar dari tile 0–1, sehingga density dan cakupan atlas
harus diselesaikan sebelum bake.
bake_texture menyiapkan target image dan menjalankan bake Cycles nyata dengan
object_name, UV, resolusi, jenis/pass, serta source/cage eksplisit bila
selected_to_active=true. Target single-image harus memiliki UV nondegenerat di
0–1. Node material yang ada dan konteks/render settings dipertahankan; image bake
tidak otomatis mengganti shader. filepath="" menghasilkan image belum
tersimpan, bukan file di disk. Gunakan path output PNG/OPEN_EXR/TIFF dan minta
overwrite=true hanya jika memang ingin mengganti file.
Kamera, HDRI, dan compositor
setup_cinematic_camera membingkai target dengan shot WIDE/HERO/PORTRAIT/MACRO,
lensa, azimuth/elevation, margin dan DOF; auto_frame_subject memakai objek
eksplisit. configure_depth_of_field memilih focus object atau jarak fokus.
load_hdri memisahkan strength pencahayaan dan background kamera;
rotate_hdri memakai derajat. Physical sky/daylight, gobo Cycles dan world fog
tersedia dengan batas kemampuan; world fog tidak berbatas volume lokal.
setup_cinematic_compositor menambahkan efek sebelum output aktif tanpa
menghapus seluruh graf. Implementasi memilih API node group compositor Blender 5
atau node tree lama berdasarkan kemampuan yang tersedia. Periksa hasil aktual,
unsupported, dan error pada sky, motion blur, displacement, dan render passes;
nama versi atau preset bukan jaminan setiap opsi didukung.
add_custom_aov masih memerlukan node Output AOV yang dihubungkan di material.
render_multilayer_exr menyimpan pass view-layer mentah, melewati compositor dan
sequencer untuk render itu lalu memulihkan output settings; bukan gambar final
compositor yang diratakan.
Proyek durable dan komponen
create_generation_project menyimpan project.json, parameter JSON, seed,
stable stage IDs, hasil/error/attempt, checkpoint, referensi dan provenance aset.
add_generation_stages menerima id, detail_level (macro/meso/micro), op
terdaftar dan params eksplisit; bukan raw Python. Contoh daftar panggilan
berikut dikirim satu per satu, bukan sebagai satu batch MCP:
[
{"name": "create_generation_project", "arguments": {
"project_dir": "C:/projects/panel", "name": "Panel", "seed": 7
}},
{"name": "add_generation_stages", "arguments": {
"project_dir": "C:/projects/panel", "stages": [{
"id": "macro_panel", "detail_level": "macro", "op": "create_object",
"params": {"type": "CUBE", "name": "Panel", "size": 1.0}
}]
}},
{"name": "run_generation_project", "arguments": {
"project_dir": "C:/projects/panel", "max_stages": 1
}}
]Setelah restart, open_generation_project membuka metadata saja, tidak
memuat atau menimpa scene. Tahap sukses tidak diulang; tahap failed/interrupted
memblokir kelanjutan sampai direkonsiliasi dan ID-nya diberikan melalui
retry_stage_ids. Efek parsial dapat masih ada: jangan retry penciptaan objek
secara buta. Runner memeriksa identitas/revisi scene; pulihkan checkpoint yang
cocok, atau gunakan confirm_scene=true hanya setelah memeriksa scene secara
eksplisit. Ini bukan izin restore otomatis.
Dengan project_dir, create_checkpoint menyimpan salinan seluruh .blend
dan indeks durable tanpa mengubah filepath aktif. File eksternal diremap,
tidak di-pack: pertahankan texture/library/aset yang direferensikan.
get_scene_diff hanya membandingkan metadata, bukan kesetaraan semua geometri.
rollback_checkpoint membuka .blend tersimpan dan mengganti seluruh scene;
wajib confirm_restore=true. Simpan pekerjaan saat ini dahulu. Checkpoint tanpa
project_dir memakai indeks sesi, bukan alur resume proyek durable.
register_component memerlukan source mesh yang sudah dibuat, dimensions_m
dan material_color eksplisit. Ukuran harus cocok dengan pengukuran source;
registrasi tidak membentuk ulang source. instantiate_component membuat mesh
linked, snap/parent dengan anchor bounding box, toleransi meter dan instance_id
stabil yang tidak boleh dipakai ulang. Warna instance dapat berbeda tanpa
mengubah mesh bersama; pemeriksaan geometri FAST terbatas bukan bukti bebas
interseksi. recommend_multiscale_detail memberi heuristik geometry/displacement/
bump dari kamera dan ukuran fitur. apply_multiscale_detail menyimpan rincian
resep persis (id, detail_level, op, params), dan hanya menjalankannya jika
run=true; ini bukan prompt-to-sculpt atau generator bentuk dari deskripsi.
Referensi → bundle → gambar native → review → refinement
Daftarkan gambar dengan
register_visual_reference(project_dir,filepath, role/view,real_dimensions[x,y,z] meter dan catatan bila tersedia). Referensi PNG/JPEG disalin ke proyek; referensi baru membuat review lama stale.Bangun tahap macro/meso/micro, lalu
create_render_review_bundledengan targetobject_nameseksplisit. Bundle berisi overall dan closeup; customviewsharus mencakup kedua role. Kamera/frame/render settings dipulihkan setelahnya; ini bukan isolasi scene atau deteksi cacat otomatis.Baca setiap referensi dan render melalui
read_project_image, memakaiimage_pathhasil tool. Ini content gambar MCP native, bukan path teks yang otomatis terlihat oleh model. Tool hanya membaca gambar proyek terdaftar yang hash-nya cocok. Klien/model harus mendukung input gambar. Referensi dibatasi 32 MiB, 16 juta piksel terdekode dan sisi 8192; transport gambar dibatasi 2 MiB dengan resize sementara bila perlu, bukan mengubah file sumber.Setelah gambar benar-benar diinspeksi, panggil
record_visual_reviewdenganbundle_iddan findings berisi tepatcategory,severity,object,evidence: {image_path, observation}, danaction. Evidence harus render dari bundle itu dan menampilkan target terkait. Verdict: CHANGES_REQUIRED, REJECTED, atau ACCEPTED. ACCEPTED memerlukan observasi positif untuk setiap gambar dan hanya severityinfo, tanpa temuan masalah yang belum selesai.execute_review_refinementsmenerimareview_iddan steps tepat{finding_id, op, params}yang merujuk temuan actionable. Pilih operasi dariallowed_refinement_operations, target eksplisit, dan batasmax_operations(default 8). Eksekusi membuat review lama stale; kegagalan/interupsi tidak boleh diputar ulang otomatis.Render bundle baru, inspeksi lagi dan catat review baru sesudah perubahan. ACCEPTED hanya berlaku untuk gambar bundle yang diperiksa, bukan kualitas scene saat ini, seluruh sudut, hasil ekspor atau frame yang tidak dilihat.
Contoh membaca satu gambar; ganti BUNDLE_IMAGE_PATH dengan image_path yang
dikembalikan create_render_review_bundle, bukan path file sembarang:
{
"name": "read_project_image",
"arguments": {
"project_dir": "C:/projects/panel",
"image_path": "BUNDLE_IMAGE_PATH", "max_dimension": 1536
}
}Addon tidak memiliki jaminan vision lokal. record_visual_review mencatat
observasi klien eksternal, bukan membuktikan bahwa klien melihat gambar.
analyze_render_quality/compare_renders mengukur statistik exposure, clipping
dan kontras; status sukses atau histogram baik tidak membuktikan kecocokan
referensi, perbaikan semantik, atau fotorealisme. Jangan menyatakan persetujuan
visual tanpa inspeksi gambar yang sebenarnya.
Aset berlisensi dan batas resource
Gunakan search_assets → get_asset_info → download_asset →
import_asset_package. Periksa source_url, author, license dan
license_requirements, lalu tampilkan provenance tersebut kepada pengguna:
Poly Haven: aset CC0; atribusi aset dihargai tetapi tidak wajib menurut lisensi aset. Saat menampilkan hasil integrasi API, tampilkan kredit Poly Haven, source dan lisensinya secara terlihat; jangan mengesankan endorsement.
Sketchfab: download hanya model yang memang downloadable, dengan OAuth
access_tokenresmi pengguna atauapi_keyakun yang berwenang. Izin download bukan pelepasan syarat lisensi; pertahankan kredit creator/source/lisensi dan periksa batas penggunaan komersial, turunan atau share-alike.Lokal: file tanpa metadata lisensi tetap unknown, bukan otomatis bebas dipakai atau didistribusikan. Dapatkan hak penggunaan dari pemiliknya.
Paket memiliki manifest/provenance, checksum dan dependency lengkap yang
divalidasi dalam batas max_download_mb; batas mencakup payload/dependency dan
ekstraksi, bukan hanya file model utama. Impor model terkelola mendukung
glTF/GLB dan OBJ/MTL, serta paket PBR/HDRI. .blend/USDZ bukan jalur impor model
terkelola: tinjau file tepercaya di Blender dan ekspor paket glTF mandiri dahulu.
source_unit_meters berarti meter per unit file OBJ; pada glTF/GLB yang sudah
berbasis meter nilainya multiplier skala. Contoh impor lokal:
{
"name": "import_asset_package",
"arguments": {
"filepath": "C:/assets/panel.glb", "project_dir": "C:/projects/panel",
"source_unit_meters": 1.0, "max_download_mb": 64
}
}Credentials provider tidak disimpan ke manifest/cache/resep. Jangan masukkan API key, token, URL bertanda tangan atau rahasia ke stage/parameter/metadata proyek; kirim kredensial hanya pada panggilan provider yang memerlukannya.
Periksa get_scene_budget/estimate_operation_cost sebelum operasi berat;
set_generation_budget membatasi objek, geometri, instance, subdivision,
texture, import dan render. Batas diketahui dapat menolak operasi sebelum
mutasi. Biaya yang tidak diketahui tetap diizinkan sambil menegakkan batas
yang diketahui (allow_unknown_costs_enforce_known_limits), bukan diasumsikan
nol atau jaminan scene tidak akan kehabisan memori.
audit_scene_resources/audit_vram_usage membedakan base, prediksi modifier,
texture/decoded-buffer estimate, dan audit depsgraph opsional evaluated=true.
Audit evaluated adalah view layer/viewport saat ini, dapat dilewati/dibatasi,
dan tidak menjamin sama dengan render akhir. actual_vram_bytes tetap null;
BVH, cache, driver, pass render dan overhead renderer tidak seluruhnya terukur.
scatter_instances membuat tepat count instance, bukan density: sampel
acak bounding box diproyeksikan ke face terdekat dengan seed deterministik.
Distribusi bukan uniform menurut luas permukaan. Surface harus memiliki
face evaluated dan tidak sudah memakai modifier Geometry Nodes; instance tetap
unrealized. Penghapusan face setelahnya membatalkan asumsi penempatan.
Chat Internal Blender (LLM)
Aktifkan di panel Axiom: pilih provider (OpenAI/Anthropic/Google/DeepSeek/
OpenRouter/Ollama), isi API key, lalu ketik perintah — mis. "buat meja kayu
dan kursi di atas lantai, warna coklat, animasikan mejanya". Asisten memakai
search_api_docs() (dokumentasi RST lokal) sebelum menulis kode, memvalidasi AST,
dan mencoba membuat checkpoint undo_push sebelum menjalankan kode. Jika kode
gagal, error asli dilaporkan; perubahan parsial tidak dibatalkan otomatis.
Keamanan
Validasi AST: pola berbahaya (
os,subprocess,__import__, dunder) diblokir sebelum eksekusiEksekusi kode: namespace baru per panggilan; validasi AST bukan sandbox penuh. Jika eksekusi gagal, output dan traceback asli dikembalikan tanpa menjalankan undo otomatis, karena undo dari timer dapat memicu crash Blender. Periksa perubahan parsial atau buka kembali salinan
.blendtersimpan sebelum mencoba ulang. Batch/job atomik memakai upaya rollback terpisah; fallback terbatas pada objek/parent/transform dan bukan pemulihan lengkap mesh/material.Rate limiting: token bucket per klien
Validasi input: pencegahan traversal path, jenis argumen diperiksa
Arsitektur
blender-mcp-ultra/
├── mcp_tools.py # Spesifikasi tool statis (FastMCP + STDIO)
├── mcp_server.py # FastMCP (SSE :9879 / stdio)
├── blender_connection.py # Klien socket TCP :9876
├── addon/ # Addon Blender (AXIOM): _axsock, handlers, modeling,
│ # materials, rigging, animation, scene_tools, ...
├── blender_mcp/ # CLI, rst_search (dokumentasi API lokal), validasi
├── src/tools/ # Katalog ToolRegistry tambahan (registry bridge)
├── data/api/ # Dokumentasi RST API Blender
├── scripts/ # install.py (auto-detect versi Blender)
├── skills/ # Instruksi workflow per domain
├── tests/ # Tes offline dengan stub + integrasi/e2e
└── demo_artifacts/ # Hasil demo LLM → Blender headlessVerifikasi
Hasil verifikasi harus menyebut versi Blender, transport, dan operasi yang
benar-benar dijalankan. Tes offline memakai stub dan tidak menggantikan smoke
di Blender nyata. Demo historis di DEMO_LLM.md memakai Blender 4.2.23 headless melalui
socket; itu tidak membuktikan seluruh fitur baru, jalur installed/native MCP,
provider jaringan, atau build Blender 5 bekerja di setiap lingkungan.
Smoke terpisah pada Blender 5.2.0 LTS (fbe6228777e7) menjalankan proyek
setelah restart/interupsi, retry eksplisit, pemulihan mesh yang dihapus melalui
checkpoint, dan komponen linked; scatter tepat 11 instance, penolakan resource
dan impor GLB lokal. PBR diuji pada unit scene 0,01, normal DirectX, rantai
dust/grain dan displacement EEVEE; SMART packing/density, color bake serta
normal bake dengan cage menghasilkan output nyata. Framing portrait/landscape,
HDRI background terpisah, compositor Blender 5, sky/fog/gobo, dan EXR multilayer
dengan header pass Combined/Depth/Normal/CryptoObject juga dijalankan.
Poly Haven wooden_table_02 dan material wood_floor_deck diuji dengan dependency
lengkap dan lisensi nyata. Transport MCP STDIO dan SDK-free mengirim gambar
native yang di-resize; image path di luar proyek ditolak. Ini bukti operasi
yang dijalankan, bukan verifikasi semua format, provider atau build.
Regresi terakhir: 510 passed, 10 skipped, dengan tiga jalur live/e2e pada perintah di atas dikecualikan. Dua skip terkait izin symlink Windows; delapan lainnya kasus capability yang sudah ada. Smoke resource native juga memastikan amplifikasi Array ditolak sebelum modifier baru dibuat, buffer image byte/float dihitung, viewport dipulihkan, dan hanya mesh identik yang dibagikan.
Model inspeksi gambar yang dikonfigurasi pada verifikasi tersebut tidak mendukung vision. Tidak ada approval semantik/fotorealisme; gambar berhasil dirender atau dikirim tidak berarti sudah dilihat dan disetujui.
Perubahan PBR/UV/render perlu diperiksa pada hasil aktual, dan review visual memerlukan gambar native yang benar-benar dibuka oleh klien berkemampuan vision. Daftar fitur dan contoh di dokumen ini adalah kontrak penggunaan, bukan klaim bahwa semua tes lulus atau bahwa hasilnya otomatis fotorealistik.
Lisensi
MIT
Available Tools
148 toolsadd_armature_modifierADestructive
Tambah modifier Armature ke mesh tanpa weight painting (background-safe).
Inputs: object_name (required), armature_name (required). Returns: result
add_boneADestructive
Tambah tulang ke armature (edit mode; memerlukan UI di Blender asli).
Inputs: armature_name (required), head, tail, parent, +2 more. Returns: result
add_constraintCDestructive
Tambah constraint (COPY_LOCATION/COPY_TRANSFORMS/TRACK_TO/IK/...).
Inputs: object_name (required), target_name (required), influence, subtarget, +1 more. Returns: result
add_geometry_nodes_modifierCDestructive
Pasang modifier Geometry Nodes + node group ke objek.
Inputs: object_name (required), name. Returns: result
add_modifierCDestructive
Tambah modifier: SUBSURF/BEVEL/BOOLEAN/ARRAY/MIRROR/SOLIDIFY/SCREW/WIREFRAME/DECIMATE/REMESH/WELD/DISPLACE/... Aman di background.
Inputs: object_name (required), axes, axis, angle, +15 more. Returns: result
add_rigid_bodyCDestructive
Jadikan objek rigid body (memerlukan UI).
Inputs: object_name (required), mass, shape, animate, +3 more. Returns: result
add_shader_nodeCDestructive
Tambah node shader: bsdf_principled/bsdf_diffuse/emission/tex_noise/tex_image/mix_shader/math/...
Inputs: material_name (required), name, node_type. Returns: result
add_shape_keyCDestructive
Tambah shape key (opsional di-keyframe).
Inputs: object_name (required), name, frame, value, +1 more. Returns: result
add_uv_mapCDestructive
Tambah layer UV ke mesh.
Inputs: object_name (required), name. Returns: result
add_vertex_colorCDestructive
Tambah layer vertex color yang dicat satu warna.
Inputs: object_name (required), color, layer_name. Returns: result
add_vertex_groupCDestructive
Buat vertex group pada mesh.
Inputs: object_name (required), group_name. Returns: result
add_wall_thicknessBDestructive
Ketebalan kulit via Solidify (mm).
Inputs: object_name (required), thickness_mm. Returns: result
align_objectsADestructive
Alinea objetos por su bounding box real (no por su origen, que suele estar descentrado). axis: X|Y|Z. mode: MIN (caras inferiores), CENTER o MAX. reference fija el objeto que no se mueve; por defecto el primero.
Inputs: names (required), axis, mode, reference. Returns: result
analyze_performanceBRead-only
Laporan anggaran poligon scene.
Inputs: no named parameters. Returns: result
animate_from_scratchADestructive
Bersihkan animasi lama lalu buat gerak lokasi/rotasi lengkap beserta rentang frame.
Inputs: object_name (required), axis, end_loc, end_frame, +5 more. Returns: result
animate_locationCDestructive
Animasi objek dari A ke B antara dua frame.
Inputs: object_name (required), end_loc, end_frame, start_loc, +2 more. Returns: result
animate_rotationCDestructive
Putar objek N putaran mengelilingi sumbu.
Inputs: object_name (required), axis, end_frame, revolutions, +3 more. Returns: result
animate_scaleCDestructive
Animasi skala objek antara dua frame.
Inputs: object_name (required), end_frame, end_scale, start_frame, +2 more. Returns: result
apply_modifiersBDestructive
Bakar semua modifier ke data mesh.
Inputs: object_name (required). Returns: result
apply_symmetryCDestructive
Tambah modifier Mirror untuk simetri industri.
Inputs: obj_name (required), axes. Returns: result
apply_transformBDestructive
Bakar transform objek ke data mesh dan reset.
Inputs: object_name (required). Returns: result
apply_transforms_allDDestructive
Bakar transform untuk semua objek mesh.
Inputs: types. Returns: result
array_objectADestructive
Duplica un objeto en fila separándolo por su propio tamaño más 'gap' metros. A diferencia del modificador Array crea objetos reales, cada uno seleccionable y editable. linked=True comparte la malla (más ligero).
Inputs: name (required), gap, axis, count, +1 more. Returns: result
assign_image_textureBDestructive
Tambah node Image Texture dan hubungkan ke Base Color.
Inputs: image_name (required), material_name (required), connect. Returns: result
assign_materialDDestructive
Tetapkan material ke objek.
Inputs: object_name (required), material_name (required). Returns: result
assign_vertex_weightsCDestructive
Tetapkan bobot ke vertex group (indeks opsional = semua).
Inputs: group_name (required), object_name (required), vertex_indices (required), mode, +1 more. Returns: result
auto_rig_weightADestructive
Parent mesh ke armature dengan bobot otomatis (memerlukan UI).
Inputs: object_name (required), armature_name (required). Returns: result
batch_delete_by_typeBDestructive
Hapus semua objek sesuai tipe.
Inputs: object_type. Returns: result
batch_duplicateCDestructive
Duplikat objek N kali dengan offset linear.
Inputs: object_name (required), count, offset. Returns: result
batch_renameBDestructive
Ganti nama objek: prefix+indeks atau search/replace.
Inputs: prefix, search, replace, start_index. Returns: result
batch_set_locationCDestructive
Geser semua objek dengan vektor.
Inputs: offset. Returns: result
batch_set_scaleBDestructive
Atur skala semua objek dengan tipe tertentu.
Inputs: scale, types. Returns: result
bed_layoutCDestructive
Susun objek dalam grid di print bed.
Inputs: object_names (required), margin_mm, bed_width_mm, bed_height_mm. Returns: result
bevel_meshCDestructive
Bevel edge atau vertex dengan bmesh.
Inputs: object_name (required), width, affect, segments. Returns: result
boolean_operationCDestructive
Boolean DIFFERENCE/UNION/INTERSECT antara dua mesh.
Inputs: object_name (required), target_object (required), operation. Returns: result
call_registry_toolADestructive
Ejecuta una tool del catálogo por nombre, p.ej. name='object.create' con params={'type':'MESH','name':'Cubo'}. Usa describe_registry_tool primero para conocer los parámetros exactos.
Inputs: name (required), params. Returns: result
check_manifoldARead-only
Analisis watertight: edge boundary/non-manifold, lubang, Euler.
Inputs: object_name (required). Returns: result
clean_meshBDestructive
Hapus vertex ganda + geometri lepas.
Inputs: object_name (required), delete_loose, merge_distance. Returns: result
cleanup_sceneBDestructive
Bersihkan datablock yatim dan normalkan nama.
Inputs: purge_unused. Returns: result
clear_keyframesBDestructive
Hapus semua keyframe properti dari action objek ('all' = semua).
Inputs: object_name (required), property. Returns: result
colorize_from_scratchCDestructive
Sekali jalan: buat + tetapkan material PBR ke objek.
Inputs: object_name (required), color, metallic, roughness. Returns: result
connect_shader_nodesCDestructive
Hubungkan dua socket node shader.
Inputs: to_node (required), to_input (required), from_node (required), from_output (required), +1 more. Returns: result
create_actionBDestructive
Buat datablock Action dan tetapkan ke objek.
Inputs: object_name (required), action_name. Returns: result
create_armatureCDestructive
Buat objek armature (opsional tulang akar).
Inputs: name, location, add_root_bone. Returns: result
create_cameraDDestructive
Buat kamera.
Inputs: rotation (required), lens, name, clip_end, +2 more. Returns: result
create_curveBDestructive
Buat kurva bezier/poly dari titik-titik.
Inputs: name, bezier, closed, points, +2 more. Returns: result
create_emptyBDestructive
Buat objek Empty (titik referensi/kontrol).
Inputs: name, location, display_type. Returns: result
create_image_textureCDestructive
Buat datablock gambar prosedural.
Inputs: name, color, width, height. Returns: result
create_lightBDestructive
Buat cahaya POINT/SUN/SPOT/AREA.
Inputs: name, color, energy, shadow, +4 more. Returns: result
create_materialBDestructive
Buat material PBR (Principled BSDF): warna, roughness, metallic, emisi, IOR, alpha, transmission, blend mode.
Inputs: ior, name, alpha, color, +6 more. Returns: result
create_objectBDestructive
Buat primitive dari nol: CUBE/PLANE/SPHERE/UVSPHERE/ICOSPHERE/CYLINDER/CONE/TORUS/MONKEY/GRID/CIRCLE/EMPTY. Aman di background.
Inputs: name, size, type, depth, +6 more. Returns: result
create_screw_profileCDestructive
Lathe/screw kurva profil mengelilingi sumbu.
Inputs: axis, name, angle, steps, +2 more. Returns: result
create_textCDestructive
Buat objek teks 3D.
Inputs: body, name, size, extrude, +2 more. Returns: result
delete_objectADestructive
Hapus objek berdasarkan nama.
Inputs: name (required). Returns: result
describe_registry_toolARead-only
Devuelve la firma exacta de una tool del catálogo: parámetros, tipos, obligatoriedad, permiso y ejemplos de uso. Consúltala antes de invocar.
Inputs: name (required). Returns: result
distribute_objectsADestructive
Reparte objetos sobre un eje. Sin 'spacing' los separa uniformemente conservando los dos extremos; con 'spacing' deja ese hueco fijo en metros entre superficies consecutivas.
Inputs: names (required), axis, spacing. Returns: result
duplicate_objectCDestructive
Duplikat objek (data dibagi).
Inputs: name (required), new_name. Returns: result
execute_blender_codeADestructive
Jalankan Python bebas di dalam Blender. Utamakan tool terstruktur; gunakan search_api_docs dulu untuk mencari API yang benar.
Inputs: code (required). Returns: result
export_glbADestructive
Export seluruh scene sebagai GLB.
Inputs: filepath (required). Returns: result
export_sceneBDestructive
Export scene: glb/gltf/fbx/obj/stl/ply/usd/usdz/dae/x3d.
Inputs: filepath (required), format. Returns: result
export_selectedBDestructive
Export objek yang dipilih.
Inputs: filepath (required), format. Returns: result
export_stl_mmCDestructive
Export STL dalam milimeter.
Inputs: filepath (required), object_name. Returns: result
extrude_faceCDestructive
Extrude satu face sepanjang offset.
Inputs: object_name (required), offset, face_index. Returns: result
find_objectsARead-only
Busca objetos por nombre, tipo (MESH, LIGHT, CAMERA...), complejidad mínima de malla o material. Evita descargar la escena entera.
Inputs: type, has_material, min_polygons, name_contains. Returns: result
fix_normalsBDestructive
Hitung ulang normal mesh agar konsisten (memerlukan UI).
Inputs: obj_name (required). Returns: result
get_blendfile_summary_datablocksCRead-only
Inventaris datablock file blend.
Inputs: no named parameters. Returns: result
get_model_blueprintARead-only
Blueprint teknis lengkap mesh: topologi, fisika, dimensi, anchor.
Inputs: obj_name (required). Returns: result
get_object_anchorsCRead-only
Kembalikan 27 titik anchor objek dalam ruang global.
Inputs: obj_name (required). Returns: result
get_object_detail_summaryBRead-only
Ringkasan mendalam satu objek: topologi, material, UV, tulang, ...
Inputs: name (required). Returns: result
get_object_infoBRead-only
Info satu objek: transform, topologi, material, modifier.
Inputs: name (required). Returns: result
get_objects_summaryARead-only
Ringkasan per objek seluruh scene.
Inputs: no named parameters. Returns: result
get_python_api_docsARead-only
Dokumentasi detail topik API Blender, mis. bpy.ops.mesh.primitive_cube_add.
Inputs: topic (required). Returns: result
get_scene_graphARead-only
Jerarquía completa de la escena (padre→hijo) con dimensiones, materiales, modificadores y polígonos. A diferencia de get_scene_info no trunca ni aplana: úsala para entender un ensamblaje antes de modificarlo.
Inputs: include_data. Returns: result
get_scene_infoBRead-only
Kondisi scene: jumlah objek, nama, tipe, lokasi.
Inputs: no named parameters. Returns: result
get_scene_propertyCRead-only
Baca properti scene apa pun.
Inputs: prop (required). Returns: result
get_spatial_visualBRead-only
Telemetri spasial ASCII scene untuk agen.
Inputs: no named parameters. Returns: result
get_viewport_screenshotARead-only
Tangkap viewport 3D ke PNG (memerlukan UI Blender).
Inputs: no named parameters. Returns: result
gn_add_nodeCDestructive
Tambah node ke GN node group objek.
Inputs: object_name (required), name, node_type. Returns: result
hide_objectCDestructive
Sembunyikan/tampilkan objek.
Inputs: object_name (required), hide. Returns: result
import_fileBDestructive
Import glb/gltf/fbx/obj/stl/ply/usd/usdz/dae.
Inputs: filepath (required), format. Returns: result
insert_keyframeCDestructive
Sisipkan keyframe (location/rotation_euler/scale/...) pada sebuah frame.
Inputs: object_name (required), frame, property. Returns: result
inset_faceCDestructive
Inset satu face.
Inputs: object_name (required), depth, thickness, face_index. Returns: result
join_objectsCDestructive
Gabungkan beberapa objek mesh menjadi satu.
Inputs: object_names (required), new_name. Returns: result
jump_to_view3d_object_by_nameBDestructive
Frame viewport 3D ke sebuah objek (memerlukan UI).
Inputs: name (required). Returns: result
keyframe_animationCDestructive
Sisipkan keyframe di beberapa frame dengan nilai yang cocok.
Inputs: object_name (required), frames, values, property, +1 more. Returns: result
list_actionsARead-only
Daftar semua action di file.
Inputs: no named parameters. Returns: result
list_bonesBRead-only
Daftar tulang armature.
Inputs: armature_name (required). Returns: result
list_export_formatsARead-only
Daftar format export yang didukung.
Inputs: no named parameters. Returns: result
list_gn_modifiersBRead-only
Daftar modifier GN pada objek.
Inputs: object_name (required). Returns: result
list_materialsARead-only
Daftar semua material di file.
Inputs: no named parameters. Returns: result
list_modifiersCRead-only
Daftar modifier pada objek.
Inputs: object_name (required). Returns: result
list_registry_toolsARead-only
Lista el catálogo completo de tools de Blender (228: mallas, materiales, nodos de geometría/shader, rigging, render, IO, UV, impresión 3D...). Filtra por categoría: objects, materials, lights, modifiers, animation, render, io, rigging, camera, scene, scene_utils, uv_texture, printing, batch, geometry_nodes, geometry_nodes_extended, shader_nodes, shader_nodes_extended. Úsala antes de call_registry_tool.
Inputs: category. Returns: result
list_shader_nodesBRead-only
Daftar node shader di node tree material.
Inputs: material_name (required). Returns: result
list_shape_keysCRead-only
Daftar shape key mesh.
Inputs: object_name (required). Returns: result
list_uv_mapsCRead-only
Daftar layer UV mesh.
Inputs: object_name (required). Returns: result
loop_cutCDestructive
Potong loop mesh sepanjang bidang (bmesh.bisect_plane).
Inputs: object_name (required), plane_co, plane_no, clear_inner, +1 more. Returns: result
measureARead-only
Mide un objeto (dimensiones, bbox, centro, volumen) o la relación entre dos: distancia entre centros, hueco real entre superficies por eje (negativo = se solapan) y si colisionan. Verifica encajes antes de anclar.
Inputs: name_a (required), name_b. Returns: result
merge_by_distanceCDestructive
Hapus vertex ganda.
Inputs: object_name (required), distance. Returns: result
mesh_analysisCRead-only
Kualitas topologi: tris/quads/ngons, non-manifold, geometri lepas.
Inputs: object_name (required). Returns: result
mirror_bonesCDestructive
Simetrikan tulang armature (memerlukan UI).
Inputs: armature_name (required), axis. Returns: result
model_from_scratchADestructive
Buat model dasar lengkap dari nol: primitive, skala, subdivision, bevel, dan smooth shading.
Inputs: name, type, scale, smooth, +3 more. Returns: result
pingARead-only
Pemeriksaan liveness terhadap Blender.
Inputs: no named parameters. Returns: result
pose_boneBDestructive
Atur transform pose bone (relatif secara default).
Inputs: scale (required), location (required), rotation (required), bone_name (required), +2 more. Returns: result
purge_orphansBDestructive
Hapus datablock yang tidak dipakai.
Inputs: no named parameters. Returns: result
remove_boneCDestructive
Hapus tulang.
Inputs: bone_name (required), armature_name (required). Returns: result
remove_modifierBDestructive
Hapus modifier berdasarkan nama.
Inputs: object_name (required), modifier_name (required). Returns: result
remove_shader_nodeDDestructive
Hapus node shader.
Inputs: node_name (required), material_name (required). Returns: result
remove_uv_mapCDestructive
Hapus layer UV.
Inputs: name (required), object_name (required). Returns: result
remove_vertex_groupDDestructive
Hapus vertex group.
Inputs: group_name (required), object_name (required). Returns: result
rename_boneCDestructive
Ganti nama tulang.
Inputs: new_name (required), bone_name (required), armature_name (required). Returns: result
render_frameCDestructive
Render frame saat ini (write_still).
Inputs: filepath. Returns: result
render_viewport_to_pathCDestructive
Render ke path file eksplisit.
Inputs: filepath (required). Returns: result
reset_poseCDestructive
Reset transform pose bone ke posisi istirahat.
Inputs: armature_name (required), bone_name. Returns: result
rig_from_scratchADestructive
Buat armature dan rantai tulang dari nol lalu ikat ke mesh. Multi-tulang di background memerlukan bobot manual.
Inputs: object_name (required), bones, auto_weight, armature_name. Returns: result
run_batchADestructive
Ejecuta varias operaciones como UNA transacción con rollback.
Cada paso es {"op": , "params": {...}}, donde es un comando (snap_and_parent, create_model, align_objects...) o una tool del catálogo (object.create, geonodes.scatter...).
Con atomic=True un fallo revierte el lote entero y la escena queda intacta. Prefiérela a encadenar llamadas sueltas: evita escenas a medio construir.
Ejemplo: steps=[{"op":"create_model","params":{"primitive":"CUBE","name":"Base"}}, {"op":"array_object","params":{"name":"Base","count":4}}]
Inputs: steps (required), label, atomic. Returns: result
scatter_instancesCDestructive
Sebarkan objek instance di permukaan via GN.
Inputs: object_name (required), instance_object (required), seed, count, +1 more. Returns: result
scene_summaryARead-only
Ringkasan scene lengkap: jumlah, rentang frame, engine.
Inputs: no named parameters. Returns: result
search_api_docsARead-only
Cari dokumentasi API Blender yang disertakan. Baca SEBELUM menulis kode.
Inputs: query (required). Returns: result
select_allADestructive
Pilih atau batalkan semua objek.
Inputs: action. Returns: result
select_by_typeCDestructive
Pilih semua objek sesuai tipe.
Inputs: object_type. Returns: result
select_objectDDestructive
Pilih satu objek.
Inputs: name (required). Returns: result
set_camera_activeCDestructive
Jadikan kamera sebagai kamera aktif scene.
Inputs: camera_name (required). Returns: result
set_camera_targetCDestructive
Buat kamera melacak objek target.
Inputs: camera_name (required), target_name (required). Returns: result
set_colorBDestructive
Atur Base Color material aktif objek.
Inputs: object_name (required), color. Returns: result
set_cycles_deviceBDestructive
Atur device Cycles: CPU / GPU / OPTIX / CUDA / HIP / METAL.
Inputs: device. Returns: result
set_dimensions_mmCDestructive
Skala objek ke dimensi milimeter presisi.
Inputs: depth_mm (required), width_mm (required), height_mm (required), object_name (required). Returns: result
set_emissionCDestructive
Buat material memancar (emissive).
Inputs: material_name (required), color, strength. Returns: result
set_frameCDestructive
Lompat timeline ke sebuah frame.
Inputs: frame. Returns: result
set_gravityCDestructive
Atur gravitasi scene.
Inputs: gravity. Returns: result
set_keyframe_interpolationCDestructive
Atur interpolasi CONSTANT/LINEAR/BEZIER pada action objek.
Inputs: object_name (required), interpolation. Returns: result
set_node_valueADestructive
Atur nilai input node shader (mis. Roughness pada Principled BSDF).
Inputs: node_name (required), input_name (required), material_name (required), value. Returns: result
set_render_engineADestructive
Atur engine render: CYCLES / EEVEE / WORKBENCH.
Inputs: engine. Returns: result
set_render_rangeCDestructive
Atur rentang frame animasi.
Inputs: end, start. Returns: result
set_render_resolutionCDestructive
Atur resolusi render.
Inputs: width, height, percentage. Returns: result
set_render_samplesBDestructive
Atur sample untuk engine aktif (Cycles/EEVEE).
Inputs: samples. Returns: result
set_scene_nameBDestructive
Ganti nama scene saat ini.
Inputs: name. Returns: result
set_transparencyCDestructive
Buat material transparan (alpha + metode blend).
Inputs: material_name (required), alpha, blend_mode. Returns: result
setup_ik_chainCDestructive
Constraint IK pada pose bone dengan chain count dan pole target.
Inputs: bone_name (required), armature_name (required), target_object (required), chain_count, +1 more. Returns: result
setup_three_point_lightingCDestructive
Cahaya key + fill + rim mengelilingi bounding box objek.
Inputs: target_name (required), intensity. Returns: result
snap_and_parentBDestructive
Snap obj_move ke obj_target dengan mencocokkan anchor 27-titik, lalu parent.
Inputs: obj_move (required), obj_target (required), anchor_move, anchor_target. Returns: result
snap_to_anchorCDestructive
Pindahkan objek agar salah satu dari 27 anchor-nya cocok dengan anchor objek lain.
Inputs: obj_move (required), obj_target (required), anchor_move, anchor_target. Returns: result
solidify_meshCDestructive
Tambah ketebalan kulit (modifier Solidify).
Inputs: object_name (required), offset, thickness. Returns: result
subdivide_meshCDestructive
Subdivide semua edge mesh (bmesh).
Inputs: object_name (required), cuts, smooth. Returns: result
texel_densityCDestructive
Skala ulang UV menuju texel density.
Inputs: object_name (required), density. Returns: result
transform_objectBDestructive
Pindah/putar/skala objek (absolut atau relatif).
Inputs: name (required), scale (required), location (required), rotation (required), +1 more. Returns: result
unhide_allBDestructive
Tampilkan semua objek.
Inputs: no named parameters. Returns: result
unwrap_objectBDestructive
Unwrap mesh: proyeksi SMART/PLANAR/CUBE/SPHERE/CYLINDER. Aman di background.
Inputs: object_name (required), name, method. Returns: result
validate_geometryBRead-only
Laporan QC: tabrakan (BVH), z-fighting, objek mengambang.
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 148 tools
Many tools have overlapping purposes, e.g., solidify_mesh, add_wall_thickness, and add_modifier with SOLIDIFY; get_scene_info, get_scene_graph, and get_objects_summary all provide scene summaries. The distinction between create_object, model_from_scratch, and rig_from_scratch is also unclear, making it hard for an agent to pick the right operation.
Most tools follow a verb_noun pattern (create_object, list_materials, set_render_engine), but there are notable deviations like 'ping', 'measure', 'find_objects', 'array_object', and 'run_batch'. The mix of generic verbs (get, set, create, add, remove) is consistent, but compound phrases like 'setup_three_point_lighting' and 'colorize_from_scratch' break the pattern.
With 148 tools plus a registry of 228, the server is extremely over-scoped. This is far beyond the typical 3-15 tool range and even exceeds the 50+ threshold, making selection overwhelming and redundant. The count is clearly inappropriate for a coherent MCP server.
The tool surface covers a vast range of Blender operations: modeling, materials, lighting, animation, rigging, UV, geometry nodes, import/export, and scripting. The registry tools and run_batch provide a fallback for any missing operation. Minor gaps exist, such as no direct tool to delete a material or edit text content, but these are workaround-able via execute_blender_code or call_registry_tool.
Related MCP Connectors
Generate game-ready 3D models, textures, and audio from natural language, over MCP.
Official faktry MCP server: generate and edit images, video, audio, and PDFs.
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
MCP server for Qwen Image 3 AI image generation
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceTransforms Blender into an MCP server with 50+ tools for AI-driven 3D workflows, enabling complete control over objects, materials, animations, physics simulations, and rendering through natural language commands.45MIT
- AlicenseBqualityDmaintenanceAn MCP server that enables AI models to directly control Blender for 3D modeling, scene manipulation, and material management through natural language. It supports advanced workflows including Python code execution, viewport visualization, and integration with external asset libraries like Poly Haven and Hyper3D.221MIT
- AlicenseBqualityBmaintenanceAn MCP server that enables AI assistants to control Blender through 108 specialized tools for 3D modeling, animation, and rendering. It provides a secure, thread-safe interface to execute validated operations in Blender using natural language commands.276196MIT
- AlicenseCqualityDmaintenanceMCP server that enables AI to control Blender 3D, providing 175 typed tools for objects, materials, animation, compositing, and more via the Model Context Protocol.1003MIT