"Blender MCP" diye arama yaptığınızda, adını değiştirmiş bir projenin kurulum kılavuzlarıyla, her fork için ayrı bir dizin sayfasıyla ve Blender'ın artık kendi sunucusuna sahip olduğu gerçeğine dair neredeyse hiçbir şeyle karşılaşırsınız. Önemli olan iki proje var, farklı işler yapıyorlar ve ikisi de varsayılan olarak aynı portu kullanıyor; bu yüzden hangisini kurduğunuzu bilmekte fayda var.
Her iki projenin kaynak kodunu ve belgelerini 14 Kasım 2026'da inceledik, MCP for Blender 2.2.9'u Blender 5.2.3 kurulu bir Mac'te MCP Inspector üzerinden çalıştırdık ve sayıları o gün GitHub, PyPI ve projects.blender.org üzerinden doğruladık.
İki sunucu
| MCP for Blender | Blender Lab MCP server | |
|---|---|---|
| Kim | ahujasid ve katkıda bulunanlar, topluluk | Blender Lab, Blender projesinin bir parçası |
| Depo | ahujasid/mcp-for-blender (eski adı blender-mcp) | projects.blender.org/lab/blender_mcp |
| Lisans | MIT | GPL-3.0-or-later |
| Yıldız | GitHub üzerinde 34.351 | projects.blender.org üzerinde 37 |
| En son sürüm | PyPI üzerinde 2.2.9, 13 Kasım 2026 | v1.0.3, 11 Eylül 2026 |
| Blender | 3.0 veya daha yeni | 5.1 veya daha yeni |
| Araçlar | 10 | 26 |
| Güçlü yönü | Sahne kurma: kod çalıştırma, sonuca bakma, varlık çekme, model üretme | Sahne okuma: özetler, doküman araması, ekran görüntüleri, nesnelere atlama |
| Claude içinde | uvx üzerinden herhangi bir istemci | Claude Desktop içindeki Blender bağlayıcısı |
İkisi de temelde aynı şekilde çalışır. Blender'ın bir ağ API'si yoktur, bu yüzden her proje iki parça sunar: Blender içinde bir TCP soketi açan bir eklenti ve istemcinizin başlattığı bir MCP server. İstemci sunucuyla MCP üzerinden konuşur, sunucu komutları soket üzerinden gönderir ve eklenti bunları Blender'ın ana iş parçacığında çalıştırır. Bu yüzden herhangi bir araç çalışmadan önce eklentinin etkinleştirilmiş ve çalışıyor olması gerekir.
Hangisini seçeceğiniz, modelin ne yapmasını istediğinize bağlıdır. Bir sahneyi modellemesini, ışıklandırmasını ve giydirmesini istiyorsanız MCP for Blender tam bu döngü için tasarlanmıştır: Python yaz, görünüm alanına bak, düzelt, tekrarla. Size gönderilen bir dosyayı anlamaya, eksik dokuları bulmaya veya "bunu Python API'sinde nasıl yaparım" sorusunu yanıtlamaya yardım istiyorsanız Blender Lab'in sunucusu bilinçli olarak daha dardır ve Blender'ın kendi kılavuzunu ve API dokümanlarını yanında taşır.
Blender için MCP, topluluk sunucusu
Çoğu eğitimin "Blender MCP" dediği şey budur. İlk olarak Mart 2025'te yayımlandı, 34.000 yıldızı geçti ve Eylül 2026'da blender-mcp adından MCP for Blender olarak yeniden adlandırıldı. Bakımcının yeniden adlandırmayla ilgili notu hiçbir şeyin bozulmadığını söylüyor: uvx blender-mcp bir uyumluluk paketi üzerinden hâlâ çalışıyor, import yolu değişmedi ve eklenti aynı dosya. Belirtilen gerekçelerin bir kısmı resmi Blender Lab projesiyle karışıklığı önlemekti. README ayrıca Blender Foundation ile bağlantılı olmadığını da açıkça belirtiyor.
On aracının ne yaptığı
Araçları MCP Inspector'ın CLI'ıyla 2.2.9 sürümüne karşı listeledik ve on tane bulduk; README'deki "dokuz araç" satırından bir fazla:
| Araç | Ne yapar |
|---|---|
execute_blender_code |
Canlı Blender oturumunda Python çalıştırır |
look |
Görünüm alanını, bir kamerayı, çok açılı bir sayfayı veya animasyon karelerini solid, material, rendered, wireframe ya da x-ray olarak gösterir |
get_scene_info |
Nesnelerin, boyutların, malzemelerin ve mesh sağlığının metin özeti |
search_assets |
Poly Haven, Sketchfab ve Poly Pizza'da arama yapar |
import_asset |
Bulunan bir varlığı sahneye getirir |
generate_3d |
Hyper3D Rodin, Hunyuan3D, Meshy veya Tripo ile metinden ya da görselden tek bir model üretir |
generate_gaussian_world |
World Labs Gaussian splat sahnesi, Blender 5.3 veya daha yenisi |
get_addon_status |
Blender ve eklenti sürümleri, hangi kütüphanelerin ve üreticilerin açık olduğu |
disable_telemetry |
Veri toplamayı kapatır |
record_trajectory_feedback |
Bir oturum hakkında geri bildirim gönderir, yalnızca katılmayı seçtiyseniz |
Onu kullanışlı kılan ikili execute_blender_code ve look. Yalnızca kod yazabilen bir model tahmin ediyordur; görünüm alanını render edip sandalyenin yerden 30 cm yukarıda durduğunu görebilen bir model ise bunu düzeltebilir. Poly Haven anahtar istemez ve varlıkları CC0'dır. Poly Pizza ücretsiz bir anahtar ister ve modellerinin yaklaşık üçte ikisi CC-BY'dir, yani yazarlara atıf borçlusunuz. Üreticiler kendi API anahtarlarınızı ya da README'nin bağlantı verdiği ücretli Premium planı gerektirir.
Kurulum
Blender 3.0 veya daha yenisi, Python 3.10 veya daha yenisi ve uv gerekir. uv'yi resmi yükleyicisiyle ya da brew install uv ile kurun; README pip install uv kullanmamanızı söylüyor.
Proje, web sitesinden bir betiği kabuğunuza aktaran tek satırlık bir yükleyici sunuyor. Çalışıyor, ama bu tür şeyleri yapıyorsanız önce okuyun. Elle yöntem iki komut ve bir onay kutusundan oluşuyor. Önce eklenti:
uvx mcp-for-blender install-addon
Bu, blender_mcp.py dosyasını Blender'ın eklenti klasörüne kopyalar ve yolu yazdırır. Ardından Blender'ı açın, Edit, Preferences, Add-ons bölümüne gidin ve "Interface: MCP for Blender" seçeneğini etkinleştirin. 3D görünümde N tuşuna basın ve MCP for Blender sekmesini açın. Sunucu çalışıyor olmalı; panel başlatmak için bir düğme sunuyorsa tıklayın. README bu düğmeye iki ayrı bölümde iki farklı ad veriyor, bu yüzden sürümünüzde hangisi görünüyorsa ona bakın.
Sonra sunucuyu istemcinize ekleyin.
Claude Code
claude mcp add blender uvx mcp-for-blender
Codex
codex mcp add blender -- uvx mcp-for-blender
Claude Desktop ve Cursor aynı JSON'u kullanır. Claude Desktop'ta claude_desktop_config.json içine (Settings, Developer, Edit Config); Cursor'da Settings, MCP ya da .cursor/mcp.json içine gider:
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["mcp-for-blender"],
"env": { "DISABLE_TELEMETRY": "true" }
}
}
}
Windows'ta Cursor "command": "cmd" ile birlikte "args": ["/c", "uvx", "mcp-for-blender"] gerektirir. env satırı isteğe bağlıdır; aşağıda açıklanan telemetri varsayılanı yüzünden orada. Aynı girdiyi birden çok istemci için tek seferde istiyorsanız, yapılandırma oluşturucumuz her biri için yazar.
Ayrıca uvx mcp-for-blender komutunu kendiniz bir terminalde çalıştırmayın. Sunucuyu istemci başlatır. İkinci bir kopya aynı Blender için yarışır ve bakımcının 52 numaralı sorundaki yanıtı kısaca, birden fazla yerde çalıştığında işe yaramayacağıydı.
Blender kapalıyken gördüklerimiz
Sunucuyu Blender çalışmıyorken MCP Inspector üzerinden başlattık. Sunucu açıldı, diskteki eklentiyi kontrol etti ("Blender addon on disk is current (protocol 16)") ve ardından Failed to connect to Blender: [Errno 61] Connection refused kaydını düştü. Araçları listeleme yine de çalıştı, çünkü liste Blender'a ihtiyaç duymuyor.
get_scene_info çağrısı, isError false olarak ayarlanmış hâlde "Could not connect to Blender. Make sure the Blender addon is running." metnini döndürdü. Bu ayrıntı kontrolleri betikleştiriyorsanız önemlidir: Inspector CLI'ı 0 ile çıktı, yani bir CI adımı hatayı başarı olarak okurdu. Yalnızca çıkış kodunu değil, sonucun metnini de kontrol edin.
Blender Lab'in resmi sunucusu
Blender Lab, Blender projesi içinde yeni şeyler denemek için Şubat 2026'da kurulmuş bir alan. MCP server'ı projects.blender.org/lab/blender_mcp adresinde ve blender.org'da bunun için bir sayfa var. Anthropic 28 Nisan 2026'da yaratıcı çalışma bağlayıcılarını duyurduğunda, Blender geliştiricilerinin artık Claude için resmi olarak sunulan bir MCP bağlayıcısı geliştirdiğini söyledi. Blender, Anthropic'in katkısını Development Fund üzerinden değil, tek seferlik bir bağış olarak almayı seçti.
26 aracı yazmaktan çok okuma yapıyor. Bir .blend dosyasının datablock'ları, eksik dosyaları, bağlı kütüphaneleri ve yolları için özetler; nesne özetleri; bir pencere veya alanın ekran görüntüleri; arayüzü bir sekmeye veya nesneye atlatma araçları; dosyaya küçük resim ve viewport render'ları; ve sunucuyla birlikte gelen Blender'ın Python API belgeleri ile kılavuzu üzerinde arama var. Birkaç dosya aracının, ayrı bir arka plan Blender'ında çalışan bir _for_cli ikizi var, böylece model açık olmayan bir dosyayı da inceleyebiliyor. Ayrıca execute_blender_code da var, yani bir şeyleri değiştirebiliyor.
Kurulum
Eklenti Blender 5.1 veya daha yenisini gerektiriyor. blender.org ve eklenti manifestosu böyle diyor; Anthropic'in Claude Academy eğitimi 4.2 diyor, ki bu güncel değil gibi görünüyor. Eklentiyi kurmak için blender.org sayfasındaki bağlantıyı Blender'a iki kez sürükleyin: ilk bırakma "lab" uzantı deposunu ekler, ikincisi kurar. Ardından Edit, Preferences, Add-ons yolunu izleyin, sekmesini açın ve MCP server'ı başlatın. Otomatik başlatmayı burada işaretleyebilirsiniz.
Claude Desktop'ta elle hiçbir şey yapılandırmıyorsunuz: Customize, Connectors yolunu açın, Blender'ı arayın ve ekleyin. Bu yalnızca Claude Desktop için geçerli, tarayıcıdaki claude.ai için değil, çünkü Blender aynı makinede çalışmak zorunda. Academy sayfası ücretsiz planın çalıştığını söylüyor.
Diğer istemciler için sürüm sayfasında bir .mcpb paketi var ya da depoyu klonlayıp istemcinizi uv ile ona yönlendirebilirsiniz:
{
"mcpServers": {
"blender": {
"command": "uv",
"args": ["--directory", "/Users/you/blender_mcp/mcp", "run", "blender-mcp"]
}
}
}
Eklenti ayrıca localhost üzerindeki 9876 portunu dinliyor. İki eklenti de etkinse aynı anda yalnızca birini başlatın ya da birini tercihlerinden başka bir porta taşıyın.
Güvenlik: iki proje de ne diyor
Her iki sunucu da modele Blender içinde bir Python yorumlayıcısı veriyor. Blender'daki Python, kullanıcı hesabınızla aynı haklara sahip olarak dosyaları okuyup silebilir, ağ bağlantıları açabilir ve program başlatabilir. Hiçbir proje bunu gizlemiyor.
MCP for Blender'ın README dosyası, execute_blender_code için "güçlü ama potansiyel olarak tehlikeli olabilir" diyor ve kalın harflerle her zaman önce çalışmanızı kaydetmenizi söylüyor. Ayrıca eklentinin soketinde kimlik doğrulama veya şifreleme olmadığını, yani porta erişebilen herkesin Blender'ınızda Python çalıştırabileceğini belirtiyor. Blender Lab'in sayfası daha da ileri gidiyor: üretilen kod "hiçbir koruma olmadan" çalışıyor ve hassas veri bulunmayan bir sanal makine ya da sistem öneriliyor.
Biz olsak şunları yapardık:
- Kaydedin ve sürümleri saklayın. Değişiklikler canlı oturumda gerçekleşir. Siz kaydedene kadar diske hiçbir şey yazılmaz; bu da kötü bir betiğin kaydedilmemiş bir saatlik çalışmanızı mahvedebileceği anlamına gelir. Preferences, Save & Load altındaki Save Versions ayarı ucuz bir sigortadır.
- MCP for Blender'da güvenli modu açın. Sunucunun
envbölümündeBLENDER_MCP_SAFE_MODE=1ayarlayın. Betikler çalıştırılmadan önce denetlenir; dosya erişimi, diğer programlar, ağ erişimi ve kalıcılık engellenir. Varsayılan olarak kapalıdır ve bazı varlık iş akışları bunun kapalı olmasını gerektirir. - Soketi localhost üzerinde tutun. Eklentide "Bind Address" ve "Allow Remote Connections" ayarları var. Bunlara dokunmayın; uzak bir Blender için SSH tüneli kullanın.
- Kodu görmeyi isteyin. Çok sayıda nesneyi silen veya yeniden adlandıran her işlem için modelden betiği çalıştırmadan önce göstermesini isteyin. Anthropic'in eğitimi de aynısını öneriyor.
- Telemetri varsayılanını kontrol edin. MCP for Blender, varsayılan olarak araç çağrısı başına minimal ve anonim bir kayıt gönderir: rastgele kurulum ve oturum kimlikleri, araç adı, başarı durumu, süre, sürümler, işletim sistemi ve zaman. İstemler, kod, ekran görüntüleri ve sahne verileri yalnızca onay kutusunu işaretlerseniz gönderilir ve README, onay verilen verilerin AI modellerini eğitmek için kullanılabileceğini söylüyor.
DISABLE_TELEMETRY=trueher şeyi kapatır.
Yerel bir MCP sunucusunun neleri erişebileceğine dair daha geniş bir bakış için MCP güvenliği sayfasına bakın.
Bağlantı kurulamadığında
Neredeyse tüm Blender MCP sorunları, istemciden Blender'a uzanan zincirdeki dört kopukluktan biridir. Bunları sırayla kontrol edin.
| Gördüğünüz | Nedeni | Çözümü |
|---|---|---|
İstemci günlüğünde spawn uvx ENOENT |
Dock veya Başlat menüsünden açılan uygulamalar terminalinizin PATH'ini almaz | Komut olarak which uvx çıktısındaki tam yolu kullanın (örneğin /opt/homebrew/bin/uvx), Windows'ta cmd /c uvx kullanın, ardından istemciyi tamamen kapatıp yeniden açın |
"Could not connect to Blender", günlükte Connection refused |
Blender kapalı, eklenti devre dışı veya sunucusu başlatılmamış | Blender'ı açın, eklentiyi etkinleştirin, N panelinden sunucuyu başlatın |
| Araçlar rastgele başarısız oluyor veya bağlantı kopuyor | Birden fazla sunucu kopyası; issue 52'deki bir kullanıcı yalnızca Claude Desktop'ı başlatmasına rağmen dört kopya bulmuş | Tek bir istemcide tutun veya diğerini kapatın; başıboş mcp-for-blender süreçlerini kontrol edin |
| Sunucu başlangıçta Python hatasıyla çöküyor | conda veya pyenv Python'u devreye girmiş ya da wheel'i olmayan yeni bir CPython | args içinde paket adından önce "--python", "3.11" ve env içinde "UV_PYTHON_PREFERENCE": "only-managed" ekleyin |
| Güncellemeden sonra eski davranış | uv önbelleği | uv cache clean mcp-for-blender blender-mcp, ardından uvx --refresh mcp-for-blender |
| Docker veya dev container içindeki sunucu Blender'a ulaşamıyor | Container içindeki localhost container'ın kendisidir |
macOS ve Windows'ta BLENDER_HOST=host.docker.internal ayarlayın; Linux'ta --network=host kullanın |
| İçe aktarma sırasında Blender donuyor | Poly Haven indirmeleri Blender'ın ana iş parçacığında çalışır | Bekleyin; indirme bitince geri döner |
| İki Blender penceresi, biri yok sayılıyor | Her iki eklenti de 9876'da | İkinci eklentiye başka bir port verin ve --port ile ikinci bir sunucu başlatın |
README ayrıca bağlandıktan sonraki ilk komutun bazen başarısız olduğunu, ikincisinin çalıştığını kabul ediyor. Sorun sürmeye devam ederse başka bir şeyi değiştirmeden önce hem istemciyi hem de Blender'daki sunucuyu yeniden başlatın.
Diğer Blender MCP sunucuları
Pek çok fork mevcut. 14 Kasım 2026'da GitHub'da, MCP for Blender sonrasında gerçek bir geçmişe sahip olanlar şunlardı: dhakalnirajan/blender-open-mcp (123 yıldız, MIT), Ollama, LM Studio veya llama.cpp üzerinden yerel modeller için geliştirilmiş ve aynı add-on portunu kullanıyor; pranav-deshmukh/blender-mcp (99 yıldız, MIT, son push Ağustos 2025); ve bpy-dev/blender-mcp (97 yıldız, GPL-3.0), Blender Lab'in sunucusunun yeniden paketlenmiş hali.
Neredeyse aynı adlara sahip, her biri yaklaşık 200 yıldızlı ve tamamı 12 Kasım 2026'da push edilmiş, biri o gün oluşturulmuş bir grup depoyu dışarıda bıraktık. İki gün içinde beliren yıldız sayıları satın alınmış gibi görünüyor ve bir add-on Blender içinde kod çalıştırıyor. Bir Blender MCP projesi yeniyse, kurmadan önce commit geçmişine ve kimlerin katkıda bulunduğuna bakın.
Blender'dan söz eden sunucuların tam listesi, checks puanları ve kurulum komutlarıyla birlikte bu sayfanın üst kısmındaki tabloda yer alıyor.
Hangisini kurmalıyım
- Hangi istemcide olursa olsun, bir ajanın sahne oluşturmasını veya değiştirmesini istiyorsanız: MCP for Blender. Hangi iş akışlarında kapalı olması gerektiğini öğrendikten sonra safe mode'u açın.
- Claude Desktop kullanıyorsanız ve çoğunlukla dosyanız veya API hakkında yanıt almak istiyorsanız: resmi Blender connector. İki tıkla kurulur ve doküman araması yanıtları Blender'ın gerçek API'sine bağlı tutar.
- Yerel bir model çalıştırıyorsanız: blender-open-mcp veya yerel arka ucunuzu destekleyen bir istemcide MCP for Blender.
- Blender 5.1'den eski bir sürümdeyseniz: ikisi arasında yalnızca MCP for Blender yüklenir.
Hangisini seçerseniz seçin, ilk işe yarar istem aynıdır: modelden herhangi bir şeyi değiştirmeden önce sahneyi betimlemesini isteyin. Bunu yapabiliyorsa, zincirin tamamı çalışıyor demektir.
