BlenderMCP - Blender Model Context Protocol Entegrasyonu

BlenderMCP, Blender'ı Claude AI'a Model Context Protocol (MCP) aracılığıyla bağlayarak Claude'un Blender ile doğrudan etkileşim kurmasını ve kontrolünü sağlar. Bu entegrasyon, isteme dayalı 3D modelleme, sahne oluşturma ve manipülasyonunu mümkün kılar.

Resmi bir web sitemiz yoktur. İnternette gördüğünüz herhangi bir web sitesi gayriresmi olup bu projeyle hiçbir bağlantısı yoktur. Bunları kendi sorumluluğunuzda kullanın.

Tam eğitim

Topluluğa Katılın

Geri bildirim verin, ilham alın ve MCP üzerinde geliştirmeler yapın: Discord

Destekçiler

CodeRabbit

Tüm destekçiler:

Bu projeyi destekleyin

Mevcut sürüm (1.5.5)

• Hunyuan3D desteği eklendi
• Sahneyi daha iyi anlamak için Blender viewport ekran görüntülerini görüntüleyin
• Sketchfab modellerini arayın ve indirin
• Poly Haven varlıklarına API aracılığıyla destek
• Hyper3D Rodin kullanarak 3D modelleri oluşturmak için destek
• Blender MCP'yi uzak bir bilgisayarda çalıştırın
• Yürütülen araçlar için telemetri (tamamen anonim)

Yeni bir sürümü yükleme (mevcut kullanıcılar)

• Yeni başlayanlar doğrudan Kuruluma gidebilir. Mevcut kullanıcılar için aşağıdaki noktalara bakın
• En son addon.py dosyasını indirin ve eskisinin yerine koyun, ardından Blender'a ekleyin
• MCP sunucusunu Claude'dan silin ve tekrar ekleyin, böylece yolunuzda olabilirsiniz!

Özellikler

• Çift yönlü iletişim: Claude AI'ı soket tabanlı sunucu aracılığıyla Blender'a bağlayın
• Nesne manipülasyonu: Blender'da 3D nesneler oluşturun, değiştirin ve silin
• Malzeme kontrolü: Malzemeleri ve renkleri uygulayın ve değiştirin
• Sahne inceleme: Mevcut Blender sahnesinin ayrıntılı bilgisini alın
• Kod yürütme: Claude'dan Blender'da rastgele Python kodu çalıştırın

Bileşenler

Sistem iki ana bileşenden oluşur:

1. Blender Eklentisi (addon.py): Blender içinde bir soket sunucusu oluşturan ve komutları almak ve yürütmek için bir Blender eklentisi
2. MCP Sunucusu (src/blender_mcp/server.py): Model Context Protocol'u uygulayan ve Blender eklentisine bağlanan bir Python sunucusu

Kurulum

Ön Koşullar

• Blender 3.0 veya daha yeni
• Python 3.10 veya daha yeni
• uv paket yöneticisi:

Mac'teyseniz, lütfen uv'yi şu şekilde yükleyin

brew install uv

Windows üzerinde

powershell -c "irm https://astral.sh/uv/install.ps1 | iex" 

ve ardından Windows'ta uv'yi kullanıcı yoluna ekleyin (Claude Desktop'ı yeniden başlatmanız gerekebilir):

$localBin = "$env:USERPROFILE\.local\bin"
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$userPath;$localBin", "User")

Aksi takdirde kurulum talimatları kendi web sitelerinde bulunur: uv'yi yükle

⚠️ UV yüklemeden önce devam etmeyin

Ortam Değişkenleri

Aşağıdaki ortam değişkenleri Blender bağlantısını yapılandırmak için kullanılabilir:

• BLENDER_HOST: Blender soket sunucusu için host adresi (varsayılan: "localhost")
• BLENDER_PORT: Blender soket sunucusu için port numarası (varsayılan: 9876)

Örnek:

export BLENDER_HOST='host.docker.internal'
export BLENDER_PORT=9876

Claude for Desktop Entegrasyonu

Kurulum talimatlarını izleyin (uv'nin zaten yüklenmiş olduğunu varsayarak)

Claude > Ayarlar > Geliştirici > Yapılandırmayı Düzenle > claude_desktop_config.json adresine gidin ve aşağıdakini ekleyin:

{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": [
                "blender-mcp"
            ]
        }
    }
}

claude mcp add blender uvx blender-mcp

Cursor entegrasyonu

Mac kullanıcıları için Ayarlar > MCP adresine gidin ve aşağıdakini yapıştırın

• Genel sunucu olarak kullanmak için "yeni genel MCP sunucusu ekle" düğmesini kullanın ve yapıştırın
• Projeye özgü sunucu olarak kullanmak için projenin kökünde .cursor/mcp.json dosyası oluşturun ve yapıştırın

{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": [
                "blender-mcp"
            ]
        }
    }
}

Windows kullanıcıları için Ayarlar > MCP > Sunucu Ekle adresine gidin, aşağıdaki ayarlarla yeni bir sunucu ekleyin:

{
    "mcpServers": {
        "blender": {
            "command": "cmd",
            "args": [
                "/c",
                "uvx",
                "blender-mcp"
            ]
        }
    }
}

Cursor kurulum videosu

⚠️ MCP sunucusunun yalnızca bir örneğini çalıştırın (Cursor veya Claude Desktop'ta), ikisini birden değil

Visual Studio Code Entegrasyonu

Ön Koşullar: Devam etmeden önce Visual Studio Code yüklü olduğundan emin olun.

Blender Eklentisini Yükleme

1. Bu repo'dan addon.py dosyasını indirin
2. Blender'ı açın
3. Düzen > Tercihler > Eklentiler adresine gidin
4. "Yükle..." seçeneğine tıklayın ve addon.py dosyasını seçin
5. "Interface: Blender MCP" seçeneğinin yanındaki kutuyu işaretleyerek eklentiyi etkinleştirin

Kullanım

Bağlantıyı Başlatma

1. Blender'da 3D Görünüm kenar çubuğuna gidin (görünür değilse N tuşuna basın)
2. "BlenderMCP" sekmesini bulun
3. API'lerinden varlıklar istiyorsanız Poly Haven onay kutusunu açın (isteğe bağlı)
4. "Claude'a Bağlan" seçeneğine tıklayın
5. MCP sunucusunun terminalinde çalıştığından emin olun

Claude ile Kullanım

Config dosyası Claude'da ayarlandığında ve eklenti Blender'da çalışırken, Blender MCP için araçları içeren çekiç simgesini görürsünüz.

Yetenekler

• Sahne ve nesne bilgilerini alın
• Şekilleri oluşturun, silin ve değiştirin
• Nesnelere malzeme uygulayın veya oluşturun
• Blender'da herhangi bir Python kodu çalıştırın
• Poly Haven aracılığıyla doğru modelleri, varlıkları ve HDRI'leri indirin
• Hyper3D Rodin aracılığıyla yapay zeka tarafından oluşturulan 3D modelleri

Örnek Komutlar

Claude'dan isteyebileceğiniz şeylere örnekler:

• "Altın bir kapı koruyan bir ejderhası olan bir zindanda düşük poli bir sahne oluştur" Demo
• "Poly Haven'dan HDRI'ler, dokular ve kayalar ve bitki örtüsü gibi modelleri kullanarak bir plaj havası oluştur" Demo
• Bir referans görüntüsü verin ve bundan bir Blender sahnesini oluşturun Demo
• "Hyper3D aracılığıyla bir bahçe cüceinin 3D modelini oluştur"
• "Mevcut sahne hakkında bilgi alın ve bundan bir threejs taslağı yapın" Demo
• "Bu arabayı kırmızı ve metalik yap"
• "Bir küre oluştur ve onu küpün üzerine koy"
• "Aydınlatmayı bir stüdyo gibi yap"
• "Kamerayı sahneye doğrult ve izometrik yap"

Hyper3D entegrasyonu

Hyper3D'nin ücretsiz deneme anahtarı, günde sınırlı sayıda modeli oluşturmanıza izin verir. Günlük sınıra ulaşılırsa, bir sonraki günün sıfırlanmasını bekleyebilir veya hyper3d.ai ve fal.ai'den kendi anahtarınızı alabilirsiniz.

Sorun Giderme

• Bağlantı sorunları: Blender eklentisi sunucusunun çalıştığından ve MCP sunucusunun Claude'da yapılandırıldığından emin olun, terminalinde uvx komutunu çalıştırmayın. Bazen ilk komut geçmeyebilir ancak bundan sonra çalışmaya başlar.
• Zaman aşımı hataları: İsteklerinizi basitleştirmeyi veya bunları daha küçük adımlara bölmeyi deneyin
• Poly Haven entegrasyonu: Claude bazen hatasız davranabilir
• Kapatıp yeniden açmayı denediniz mi?: Hala bağlantı hatalarıyla karşılaşıyorsanız, hem Claude'u hem de Blender sunucusunu yeniden başlatmayı deneyin

Teknik Ayrıntılar

İletişim Protokolü

Sistem TCP soketleri üzerinde basit bir JSON tabanlı protokol kullanır:

• Komutlar type ve isteğe bağlı params içeren JSON nesneleri olarak gönderilir
• Yanıtlar status ve result veya message içeren JSON nesneleridir

Sınırlamalar ve Güvenlik Konuları

• execute_blender_code aracı Blender'da rastgele Python kodu çalıştırmaya izin verir, bu güçlü olabilir ancak potansiyel olarak tehlikeli olabilir. Üretim ortamlarında dikkatle kullanın. HER ZAMAN bunu kullanmadan önce çalışmanızı kaydedin.
• Poly Haven, modelleri, dokuları ve HDRI görüntülerini indirmeyi gerektirir. Bunu kullanmak istemiyorsanız, Blender'daki onay kutusunu kapatın.
• Karmaşık işlemler daha küçük adımlara bölünmesi gerekebilir

Telemetri Kontrolü

BlenderMCP, aracı geliştirmeye yardımcı olmak için anonim kullanım verilerini toplar. Telemetriyi iki şekilde kontrol edebilirsiniz:

1. Blender'da: Düzen > Tercihler > Eklentiler > Blender MCP adresine gidin ve telemetri onay kutusu'nun işaretini kaldırın

   • Onay ile (işaretli): Anonim hale getirilmiş istemler, kod parçacıkları ve ekran görüntülerini toplar
   • Onay olmadan (işaretsiz): Yalnızca minimal anonim kullanım verilerini toplar (araç adları, başarı/başarısızlık, süre)

2. Ortam Değişkeni: Şunu çalıştırarak tüm telemetriyi tamamen devre dışı bırakın:

DISABLE_TELEMETRY=true uvx blender-mcp

Veya MCP yapılandırmanıza ekleyin:

{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": ["blender-mcp"],
            "env": {
                "DISABLE_TELEMETRY": "true"
            }
        }
    }
}

Tüm telemetri verileri tamamen anonim hale getirilir ve yalnızca BlenderMCP'yi iyileştirmek için kullanılır.

Katkıda Bulunma

Katkılar hoş karşılanır! Lütfen bir Pull Request göndermekten çekinmeyin.

Feragatname

Bu, Blender tarafından yapılmayan üçüncü taraf bir entegrasyon. Siddharth tarafından yapılmıştır