Cari "Blender MCP" dan yang Anda dapat adalah panduan install untuk proyek yang sudah berganti nama, halaman direktori untuk setiap fork, dan nyaris tidak ada informasi bahwa Blender sekarang punya server sendiri. Ada dua proyek yang penting, keduanya mengerjakan hal berbeda, dan keduanya memakai port default yang sama, jadi penting untuk tahu mana yang sedang Anda install.
Kami membaca source dan dokumentasi kedua proyek pada 14 November 2026, menjalankan MCP for Blender 2.2.9 lewat MCP Inspector di Mac dengan Blender 5.2.3 terpasang, dan memeriksa angkanya terhadap GitHub, PyPI, dan projects.blender.org pada hari itu.
Dua server
| MCP for Blender | Blender Lab MCP server | |
|---|---|---|
| Siapa | ahujasid dan kontributor, komunitas | Blender Lab, bagian dari proyek Blender |
| Repositori | ahujasid/mcp-for-blender (dulu blender-mcp) | projects.blender.org/lab/blender_mcp |
| Lisensi | MIT | GPL-3.0-or-later |
| Stars | 34.351 di GitHub | 37 di projects.blender.org |
| Versi terbaru | 2.2.9 di PyPI, 13 November 2026 | v1.0.3, 11 September 2026 |
| Blender | 3.0 atau lebih baru | 5.1 atau lebih baru |
| Tool | 10 | 26 |
| Keunggulan | Membangun scene: jalankan kode, lihat hasilnya, ambil aset, generate model | Membaca scene: ringkasan, pencarian dokumentasi, screenshot, lompat ke objek |
| Di Claude | Client apa pun lewat uvx | Konektor Blender di Claude Desktop |
Keduanya bekerja dengan cara yang sama di baliknya. Blender tidak punya network API, jadi tiap proyek menyertakan dua bagian: add-on yang membuka socket TCP di dalam Blender, dan MCP server yang dijalankan oleh client Anda. Client berbicara MCP ke server, server mengirim perintah lewat socket, dan add-on menjalankannya di main thread Blender. Itulah sebabnya add-on harus diaktifkan dan berjalan sebelum tool mana pun bisa dipakai.
Mana yang dipilih tergantung pada apa yang ingin Anda buat modelnya lakukan. Kalau Anda ingin model memodelkan, memberi pencahayaan, dan menata scene, MCP for Blender memang dirancang untuk alur itu: tulis Python, lihat viewport, perbaiki, ulangi. Kalau Anda ingin bantuan memahami file yang dikirim orang lain, menemukan tekstur yang hilang, atau menjawab "bagaimana cara melakukan ini di Python API", server dari Blender Lab sengaja dibuat lebih sempit cakupannya dan membawa manual serta dokumentasi API milik Blender.
MCP for Blender, server komunitas
Inilah yang oleh sebagian besar tutorial disebut "Blender MCP". Pertama dirilis pada Maret 2025, menembus 34.000 stars, dan pada September 2026 berganti nama dari blender-mcp menjadi MCP for Blender. Catatan maintainer soal penggantian nama itu menyebut tidak ada yang rusak: uvx blender-mcp tetap berjalan lewat paket kompatibilitas, path import tidak berubah, dan add-on-nya file yang sama. Salah satu alasan yang disebutkan adalah untuk menghindari kebingungan dengan proyek resmi Blender Lab. README-nya juga menegaskan bahwa proyek ini tidak berafiliasi dengan Blender Foundation.
Apa fungsi sepuluh tool-nya
Kami mendaftar tool-nya dengan CLI MCP Inspector terhadap versi 2.2.9 dan mendapat sepuluh, satu lebih banyak dari baris "nine tools" di README:
| Tool | Fungsinya |
|---|---|
execute_blender_code |
Menjalankan Python di sesi Blender yang sedang aktif |
look |
Menampilkan viewport, kamera, sheet multi-angle, atau frame animasi, dalam mode solid, material, rendered, wireframe, atau x-ray |
get_scene_info |
Ringkasan teks soal objek, ukuran, material, dan kesehatan mesh |
search_assets |
Mencari di Poly Haven, Sketchfab, dan Poly Pizza |
import_asset |
Memasukkan aset yang ditemukan ke dalam scene |
generate_3d |
Membuat satu model dari teks atau gambar dengan Hyper3D Rodin, Hunyuan3D, Meshy, atau Tripo |
generate_gaussian_world |
Scene Gaussian splat dari World Labs, Blender 5.3 atau lebih baru |
get_addon_status |
Versi Blender dan add-on, library dan generator mana yang aktif |
disable_telemetry |
Mematikan pengumpulan data |
record_trajectory_feedback |
Mengirim feedback soal sesi, hanya jika Anda sudah opt in |
Pasangan yang membuatnya berguna adalah execute_blender_code dan look. Model yang hanya bisa menulis kode itu menebak; model yang bisa me-render viewport dan melihat bahwa kursinya melayang 30 cm di atas lantai bisa memperbaikinya. Poly Haven tidak butuh key dan asetnya CC0. Poly Pizza butuh key gratis dan sekitar dua pertiga modelnya CC-BY, jadi Anda wajib memberi kredit ke pembuatnya. Generator butuh API key Anda sendiri, atau paket Premium berbayar yang ditautkan di README.
Cara install
Anda perlu Blender 3.0 atau lebih baru, Python 3.10 atau lebih baru, dan uv. Install uv dengan installer resminya atau brew install uv; README menyarankan jangan pakai pip install uv.
Proyek ini menyediakan installer satu baris yang menyalurkan script dari situsnya ke shell Anda. Cara itu berhasil, tapi baca dulu script-nya kalau Anda memang biasa begitu. Jalur manual cuma dua perintah dan satu checkbox. Pertama add-on-nya:
uvx mcp-for-blender install-addon
Perintah itu menyalin blender_mcp.py ke folder add-ons Blender dan mencetak path-nya. Lalu buka Blender, masuk ke Edit, Preferences, Add-ons, dan aktifkan "Interface: MCP for Blender". Tekan N di 3D view dan buka tab MCP for Blender. Server seharusnya sudah berjalan; kalau panelnya menawarkan tombol untuk memulainya, klik tombol itu. README menyebut tombol itu dengan dua nama berbeda di dua bagian, jadi cari nama yang muncul di versi Anda.
Setelah itu tambahkan server ke client Anda.
Claude Code
claude mcp add blender uvx mcp-for-blender
Codex
codex mcp add blender -- uvx mcp-for-blender
Claude Desktop dan Cursor memakai JSON yang sama. Di Claude Desktop letaknya di claude_desktop_config.json (Settings, Developer, Edit Config); di Cursor, di Settings, MCP, atau .cursor/mcp.json:
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["mcp-for-blender"],
"env": { "DISABLE_TELEMETRY": "true" }
}
}
}
Di Windows, Cursor butuh "command": "cmd" dengan "args": ["/c", "uvx", "mcp-for-blender"]. Baris env opsional; baris itu ada karena default telemetri yang dijelaskan di bawah. Kalau Anda ingin entri yang sama untuk beberapa client sekaligus, config builder kami menuliskannya untuk masing-masing.
Jangan jalankan uvx mcp-for-blender sendiri di terminal juga. Client yang memulai server. Salinan kedua akan berebut Blender yang sama, dan jawaban maintainer di issue 52 singkat saja: tidak akan berfungsi kalau berjalan di lebih dari satu tempat.
Yang kami lihat saat Blender ditutup
Kami memulai server lewat MCP Inspector dengan Blender tidak berjalan. Server tetap menyala, memeriksa add-on di disk ("Blender addon on disk is current (protocol 16)"), lalu mencatat Failed to connect to Blender: [Errno 61] Connection refused. Listing tool tetap berhasil, karena daftarnya tidak butuh Blender.
Memanggil get_scene_info mengembalikan teks "Could not connect to Blender. Make sure the Blender addon is running." dengan isError bernilai false. Detail itu penting kalau Anda menulis script pengecekan: CLI Inspector keluar dengan kode 0, jadi langkah CI akan membaca kegagalan itu sebagai sukses. Periksa teks hasilnya, bukan hanya exit code.
Server resmi Blender Lab
Blender Lab adalah ruang di dalam proyek Blender untuk mencoba hal-hal baru, dibentuk pada Februari 2026. MCP server-nya ada di projects.blender.org/lab/blender_mcp, dan blender.org punya halaman khusus untuknya. Saat Anthropic mengumumkan connector untuk pekerjaan kreatif pada 28 April 2026, mereka menyebut bahwa para developer Blender telah membangun MCP connector yang kini tersedia resmi untuk Claude. Blender memilih menerima kontribusi Anthropic sebagai donasi sekali saja, bukan lewat Development Fund.
Ke-26 tool-nya lebih banyak membaca daripada menulis. Ada ringkasan datablock sebuah file .blend, file yang hilang, linked library, dan path; ringkasan objek; screenshot sebuah window atau area; tool untuk melompatkan antarmuka ke tab atau objek tertentu; render thumbnail dan viewport ke file; serta pencarian di dokumentasi Python API dan manual Blender, yang ikut disertakan bersama server. Beberapa tool file punya kembaran _for_cli yang berjalan di Blender background terpisah, jadi model bisa memeriksa file yang sedang tidak Anda buka. Ada juga execute_blender_code, jadi ia bisa mengubah sesuatu juga.
Cara install
Add-on ini butuh Blender 5.1 atau lebih baru. Itu yang tertulis di blender.org dan di manifest add-on; tutorial Claude Academy dari Anthropic menyebut 4.2, sepertinya sudah kedaluwarsa. Install add-on dengan menyeret link dari halaman blender.org ke Blender dua kali: drop pertama menambahkan repositori ekstensi "lab", drop kedua melakukan install. Lalu buka Edit, Preferences, Add-ons, buka tab-nya dan jalankan MCP server. Di situ Anda juga bisa mencentang auto-start.
Di Claude Desktop Anda tidak perlu mengonfigurasi apa pun secara manual: buka Customize, Connectors, cari Blender lalu tambahkan. Ini hanya untuk Claude Desktop, bukan claude.ai di browser, karena Blender harus berjalan di mesin yang sama. Halaman Academy menyebut paket gratis juga bisa dipakai.
Untuk client lain, halaman release menyediakan bundle .mcpb, atau Anda clone repositorinya dan arahkan client Anda ke sana dengan uv:
{
"mcpServers": {
"blender": {
"command": "uv",
"args": ["--directory", "/Users/you/blender_mcp/mcp", "run", "blender-mcp"]
}
}
}
Add-on ini juga mendengarkan di localhost port 9876. Kalau Anda mengaktifkan kedua add-on, jalankan hanya satu dalam satu waktu, atau pindahkan salah satunya ke port lain lewat preferensinya.
Keamanan: apa yang dikatakan kedua proyek
Kedua server memberi model sebuah interpreter Python di dalam Blender. Python di Blender bisa membaca dan menghapus file, membuka koneksi jaringan, dan menjalankan program, dengan hak yang sama seperti akun pengguna Anda. Tidak ada proyek yang menyembunyikan hal ini.
README MCP for Blender menyebut execute_blender_code "can be powerful but potentially dangerous" dan menyarankan Anda, dengan huruf tebal, untuk selalu menyimpan pekerjaan terlebih dahulu. README itu juga menyebut socket pada add-on tidak memiliki autentikasi atau enkripsi, jadi siapa pun yang bisa menjangkau port tersebut dapat menjalankan Python di Blender Anda. Halaman Blender Lab lebih jauh lagi: kode yang dihasilkan berjalan "without any guards in place" dan mereka merekomendasikan virtual machine atau sistem tanpa data sensitif.
Yang akan kami lakukan dalam praktik:
- Simpan, dan pertahankan versi. Perubahan terjadi di sesi yang sedang berjalan. Tidak ada yang ditulis ke disk sampai Anda menyimpan, yang juga berarti skrip yang buruk bisa merusak pekerjaan satu jam yang belum disimpan. Pengaturan Save Versions di Preferences, Save & Load adalah asuransi murah.
- Aktifkan safe mode di MCP for Blender. Set
BLENDER_MCP_SAFE_MODE=1dienvserver. Skrip diperiksa sebelum dijalankan, dan akses file, program lain, akses jaringan, serta persistence diblokir. Fitur ini mati secara default, dan beberapa alur kerja aset memerlukannya dalam keadaan mati. - Biarkan socket di localhost. Add-on punya pengaturan "Bind Address" dan "Allow Remote Connections". Biarkan apa adanya; untuk Blender di mesin remote, gunakan SSH tunnel.
- Minta untuk melihat kodenya. Untuk apa pun yang menghapus atau mengganti nama banyak objek, minta model menunjukkan skripnya sebelum menjalankannya. Tutorial dari Anthropic juga menyarankan hal yang sama.
- Periksa default telemetri. MCP for Blender mengirim catatan anonim minimal per pemanggilan tool secara default: ID install dan sesi acak, nama tool, status berhasil, durasi, versi, OS, dan waktu. Prompt, kode, screenshot, dan data scene hanya dikirim jika Anda mencentang kotak persetujuan, dan README menyebut data yang di-opt-in dapat digunakan untuk melatih model AI.
DISABLE_TELEMETRY=truemematikan semuanya.
Untuk gambaran lebih luas tentang apa yang bisa dijangkau sebuah MCP server lokal, lihat MCP security.
Saat tidak bisa terhubung
Hampir semua masalah Blender MCP adalah salah satu dari empat titik putus dalam rantai dari client ke Blender. Periksa berurutan.
| Yang Anda lihat | Penyebab | Solusi |
|---|---|---|
spawn uvx ENOENT di log client |
Aplikasi yang dijalankan dari Dock atau Start menu tidak mendapat PATH terminal Anda | Pakai path lengkap dari which uvx (misalnya /opt/homebrew/bin/uvx) sebagai command, atau cmd /c uvx di Windows, lalu tutup client sepenuhnya dan buka lagi |
"Could not connect to Blender", log menyebut Connection refused |
Blender tertutup, add-on nonaktif, atau server-nya belum dijalankan | Buka Blender, aktifkan add-on, jalankan server di panel N |
| Tool gagal secara acak atau koneksi terputus | Ada lebih dari satu salinan server; satu pengguna di issue 52 menemukan empat padahal hanya menjalankan Claude Desktop | Simpan di satu client saja, atau tutup yang lain; cek proses mcp-for-blender yang tersisa |
| Server crash saat start dengan error Python | Python dari conda atau pyenv yang terpakai, atau CPython baru yang belum ada wheel-nya | Tambahkan "--python", "3.11" sebelum nama package di args dan "UV_PYTHON_PREFERENCE": "only-managed" di env |
| Perilaku lama masih muncul setelah update | Cache uv | uv cache clean mcp-for-blender blender-mcp, lalu uvx --refresh mcp-for-blender |
| Server di Docker atau dev container tidak bisa menjangkau Blender | localhost di dalam container adalah container itu sendiri |
Set BLENDER_HOST=host.docker.internal di macOS dan Windows; di Linux pakai --network=host |
| Blender freeze saat import | Unduhan Poly Haven berjalan di main thread Blender | Tunggu; proses kembali normal setelah unduhan selesai |
| Dua jendela Blender, satu diabaikan | Kedua add-on memakai 9876 | Beri add-on kedua port lain dan jalankan server kedua dengan --port |
README juga mengakui bahwa command pertama setelah terhubung kadang gagal dan yang kedua berhasil. Kalau terus gagal, restart client dan server di Blender sebelum mengubah hal lain.
MCP server Blender lainnya
Fork-nya banyak sekali. Di GitHub pada 14 November 2026, yang punya riwayat nyata setelah MCP for Blender adalah dhakalnirajan/blender-open-mcp (123 stars, MIT), dibuat untuk model lokal lewat Ollama, LM Studio, atau llama.cpp dan memakai port add-on yang sama; pranav-deshmukh/blender-mcp (99 stars, MIT, terakhir di-push Agustus 2025); dan bpy-dev/blender-mcp (97 stars, GPL-3.0), hasil repackaging server dari Blender Lab.
Kami sengaja melewatkan sekelompok repositori dengan nama yang nyaris identik dan masing-masing sekitar 200 stars, semuanya di-push pada 12 November 2026, salah satunya dibuat di hari yang sama. Jumlah star yang muncul dalam dua hari terlihat seperti dibeli, dan add-on menjalankan kode di dalam Blender. Kalau sebuah proyek Blender MCP masih baru, periksa riwayat commit dan siapa kontributornya sebelum Anda install.
Daftar lengkap server yang menyebut Blender, lengkap dengan skor checks dan perintah install, ada di tabel di bagian atas halaman ini.
Mana yang perlu di-install
- Anda ingin agent membangun atau mengubah scene, di client apa pun: MCP for Blender. Aktifkan safe mode setelah Anda tahu workflow mana yang perlu mematikannya.
- Anda memakai Claude Desktop dan sebagian besar hanya ingin jawaban tentang file atau API Anda: connector resmi Blender. Cukup dua klik, dan pencarian dokumentasinya menjaga jawaban tetap mengacu ke API Blender yang sebenarnya.
- Anda menjalankan model lokal: blender-open-mcp, atau MCP for Blender di client yang mendukung backend lokal Anda.
- Anda memakai Blender versi lebih lama dari 5.1: MCP for Blender adalah satu-satunya dari keduanya yang bisa dimuat.
Apa pun pilihan Anda, prompt berguna pertama tetap sama: minta model mendeskripsikan scene sebelum mengubah apa pun. Kalau model bisa melakukannya, seluruh rangkaiannya berjalan.