Godot Asset Library'de "mcp" araması yaptığınızda yalnızca Godot 4.7 için on dokuz kayıt çıkıyor; birkaçının adı aynı. GitHub'da daha fazlası var. Hiçbiri Godot projesinden gelmiyor; proje, LLM'leri motora bağlamaya yönelik bir öneriyi "planlanmadı" olarak kapattı. Yani bir Godot MCP server seçmek, çok farklı şekillerde çalışan, farklı Godot sürümlerini destekleyen ve birkaçında ciddi güvenlik hataları bulunan topluluk projeleri arasında seçim yapmak anlamına geliyor.
Önde gelen projeleri 14 Kasım 2026'da depolarına, npm ve PyPI kayıtlarına, Asset Library API'sine ve GitHub'ın güvenlik bildirimleri veritabanına karşı kontrol ettik. En çok kullanılanı, Coding-Solo'nun godot-mcp'sini de kurup bir Mac'te Godot 4.7.2 ile çalıştırdık.
Bir Godot MCP server'ın çalışma biçimlerinin üç yolu
| Biçim | Godot'a nasıl ulaşır | Editör açık mı? | Örnekler |
|---|---|---|---|
| Headless | Her işlem için bir script ile godot binary'sini başlatır |
Hayır | Coding-Solo/godot-mcp |
| Editör eklentisi | Projenizdeki bir addon, server ile WebSocket veya HTTP üzerinden konuşur | Evet | godot-ai, Godlink, Godot MCP Pro, Godot-MCP-Native |
| Editör ve runtime | Editör için eklenti, çalışan oyunun içinde bir autoload | Evet, oyun araçları için oyun çalışır durumda | tugcantopaloglu/godot-mcp, GoPeak |
Headless tür en basitidir: projenize kurulacak bir şey yok, bir portu dinleyen bir şey yok. Dosyaları disk üzerinde düzenler, bu yüzden editörde neyin seçili olduğunu veya oyun çalışırken nasıl göründüğünü göremez. Eklenti türü ikisini de yapabilir, ancak bunun bedeli projenizde bir addon ve makinenizdeki başka bir şeyin de konuşabileceği yerel bir porttur. Runtime türü en ileri gider ve agent'ın canlı oyunu okumasına ve değiştirmesine izin verir.
Bilinmeye değer sunucular
| Sunucu | Yıldız | Lisans | Biçim | Araçlar | Godot | Notlar |
|---|---|---|---|---|---|---|
| Coding-Solo/godot-mcp | 6.640 | MIT | Headless | 14 (ölçüldü) | 4.x, UID araçları 4.4+ | npm 0.1.1; son push Nisan 2026 |
| hi-godot/godot-ai | 3.526 | MIT | Editör eklentisi | 46 | 4.7+ | Aktif; Ekim 2026'da dört güvenlik bildirimi düzeltildi |
| yurineko73/Godot-MCP-Native | 874 | MIT | Eklenti, sunucu GDScript ile yazılmış | 155 (README) | 4.6 için Asset Library kaydı | Node veya Python gerekmiyor |
| youichi-uda/godot-mcp-pro | 643 | Eklenti herkese açık, sunucu ücretli | Editör eklentisi | 187 (README) | 4.4 | Tek seferlik satın alma |
| tugcantopaloglu/godot-mcp | 512 | MIT | Headless ve çalışma zamanı | 157 (README) | 4.x | npm paketi deponun çok gerisinde |
| tomyud1/godot-mcp (Godlink) | 454 | MIT | Editör eklentisi | 69 (README) | 4.4+ | localhost'a bağlanır; Asset Store'da |
| IvanMurzak/Godot-MCP | 343 | Apache-2.0 | C# eklentisi | belirtilmemiş | 4.3 ile 4.7 arası, .NET derlemesi | Varsayılan olarak bulut aktarımı |
| ee0pdt/Godot-MCP | 622 | MIT | Editör eklentisi | yaklaşık 20 | belirtilmemiş | Mart 2025'ten beri push yok; Güvenlik bölümüne bakın |
Bu listeyle ilgili iki uyarı. Birincisi, adlar çakışıyor: "Godot MCP" birbiriyle ilgisiz birkaç projenin başlığı, bu yüzden kurmadan önce sahibini ve Asset Library'de varlık kimliğini kontrol edin. İkincisi, kütüphane sürümleri geride kalıyor: Asset Library hâlâ godot-ai 3.2.5 sunuyor, oysa proje 4.4.1'de; tugcantopaloglu'nun forkunun npm paketi ise GitHub'daki 3.1.0'a karşılık 1.0.0.
"godot mcp" aramasında çıkan birkaç depo aslında Godot MCP sunucusu değil; bunlar arasında bir Blender beceri koleksiyonu ve oyun motorları için bir masaüstü uygulaması da var; bunlardan biri dört izleyiciyle 31 günde 1.072 yıldıza ulaştı.
Coding-Solo'nun sunucusu, test edildi
Godot kurulu olmalı ve Node.js 18 veya daha yeni bir sürüm gerekiyor. Claude Code'a eklemek için:
claude mcp add godot -- npx @coding-solo/godot-mcp
Diğer istemciler için JSON, aynı komuttur:
{
"mcpServers": {
"godot": {
"command": "npx",
"args": ["@coding-solo/godot-mcp"],
"env": { "GODOT_PATH": "/Applications/Godot.app/Contents/MacOS/Godot" }
}
}
}
GODOT_PATH yalnızca sunucu Godot'u bulamazsa gerekir; bizim Mac'imizde /Applications/Godot.app/Contents/MacOS/Godot yolunu kendisi buldu. Daha fazla günlük için DEBUG=true ayarlayın.
tools/list yanıtında dönen 14 aracı: launch_editor, run_project, get_debug_output, stop_project, get_godot_version, list_projects, get_project_info, create_scene, add_node, load_sprite, export_mesh_library, save_scene, get_uid ve update_project_uids.
Yalnızca bir project.godot dosyası içeren boş bir proje oluşturduk ve araçları MCP Inspector üzerinden tek tek çağırdık:
| Çağrı | Sonuç | Süre |
|---|---|---|
get_godot_version |
4.7.2.stable.official.ed1daf0bf |
6 sn, ilk çalıştırma npx indirmesini içeriyor |
Kökü Node2D olan create_scene |
scenes/main.tscn yazıldı |
2 sn |
Player adında Sprite2D türünde add_node |
Düğüm sahneye eklendi | 1 sn |
get_project_info |
Ad, yol, Godot sürümü, sahne ve betik sayıları | 1 sn |
Var olmayan bir sahneye add_node |
Önerilerle birlikte isError: true |
1 sn |
Yazdığı sahne dosyası geçerli Godot 4 biçimindeydi: root adında bir Node2D ve altında Player adında bir Sprite2D. Hatalar düzgün şekilde hata olarak bildirildi; "Use create_scene to create a new scene first" gibi öneriler bir aracın kendi başına toparlanmasına yardımcı oluyor.
Bilmeniz gereken bir şey var: başarılı yanıtlar Godot'un kendi konsol çıktısını ve tam bağımsız değişken listesini içeriyor. create_scene yanıtımız 5.074 bayttı ve büyük kısmı hata ayıklama metniydi. Birkaç çağrı için zararsız, ancak uzun bir oturumda birikiyor.
Yapamadığı şey, düzenleyiciye veya çalışan oyuna bakmak. run_project oyunu başlatıyor ve get_debug_output konsolunu döndürüyor; böylece bir aracı çalıştırabilir, hataları okuyabilir ve betikleri düzeltebilir, ancak ekranda ne olduğunu göremez. Buna ihtiyacınız varsa eklenti tabanlı bir sunucu seçin.
Eklenti sunucuları
godot-ai (hi-godot) en aktif olanı. Eklentisi addons/godot_ai/ altına gider; Asset Store sekmesinden veya bir sürüm zip'inden kurulur, Project Settings > Plugins altında etkinleştirilir ve ardından dock'undaki Configure düğmesiyle istemciniz için yapılandırma yazılır. Godot 4.7 veya daha yenisini ve uv gerektirir. İstemci, yerel bir Python sunucusu olan godot-ai attach üzerinden ve düzenleyiciye açılan kimlik doğrulamalı bir WebSocket ile bağlanır. Sahne, düğüm, betik, test çalıştırma, günlükler ve düzenleyici ekran görüntülerini kapsayan 46 aracı vardır. Yeni bir sürümü eski eklenti klasörünün üzerine açmayın; README dosyasında dock'taki Update düğmesinin kullanılması söyleniyor.
Godlink (tomyud1) Godot 4.4 ve daha yenisini destekler. 4.7'de Asset Store'dan, eski sürümlerde Asset Library'den (ID 4767) kurun, eklentiyi etkinleştirin ve istemcinize npx -y godot-mcp-server ekleyin. Düzenleyicideki bir etiket "MCP: Agent Active", "No Agent" veya "Disconnected" gösterir. 69 aracı arasında oyunu çalıştırma, girdi gönderme ve ekran görüntüsü alma da var. Değişiklikler diske yazılır, bu yüzden düzenleyicideki Ctrl+Z bunları geri almaz; kendi mcp_undo komutu vardır.
Godot-MCP-Native MCP server'ın kendisini GDScript ile yazar, böylece kurulacak Node veya Python yoktur. 9080 portunda HTTP sunar, isteğe bağlı bir bearer token ile. Godot MCP Pro kendi sayımına göre en çok araca sahip, ancak server'ı ayrı satılıyor.
Birden fazlasını denerseniz port çakışmaları olabilir: Godlink ve Godot MCP Pro varsayılan olarak 6505'i, ee0pdt ve Godot-MCP-Native ise 9080'i kullanır.
Güvenlik
Oyun projeleri koddur ve birçok Godot MCP server'ı editörün veya oyunun içinde rastgele kod çalıştırabilir: godot-ai'da ve tugcantopaloglu'nun fork'unda game_eval, Godot MCP Pro'da execute_editor_script ve execute_game_script, Godot-MCP-Native'de execute-script, IvanMurzak'ınkinde C# için script-execute. Zaten amaçları da bu ve bu da ajanı yönlendiren bir prompt'un kullanıcı hesabınızın yapabildiği her şeyi yapabileceği anlamına gelir.
GitHub'ın advisory veritabanındaki yayımlanmış güvenlik açıkları:
| Proje | Advisory | Ne | Düzeltildiği sürüm |
|---|---|---|---|
| Coding-Solo/godot-mcp | CVE-2026-25546, yüksek | projectPath üzerinden komut enjeksiyonu |
0.1.1 (Şubat 2026) |
| GoPeak | GHSA-v24g-v3px-jxv7, yüksek | Araç argümanları üzerinden komut enjeksiyonu | 2.4.1, yalnızca GitHub releases; npm paketi kullanımdan kaldırıldı |
| hi-godot/godot-ai | Dört advisory, Ekim 2026 | Windows'ta yazma blocklist'ini atlatma, kimlik bilgisi dosyalarının okunabilir hale gelmesi, sahte olarak kandırılabilen bir host kontrolü | Yamalanmış sürüm için ilgili advisory'ye bakın |
Coding-Solo'nun server'ında daha ince bir nokta var. 16 Nisan 2026'da birleştirilen ek bir düzeltme, add_node ve create_scene'in düğüm türü olarak verilen bir script'i yüklemesini engelliyor; bu, o script'in kodunu çalıştırırdı. En son npm sürümü olan 0.1.1 Şubat'tan. Daha yeni bir sürüm çıkmadıkça npm paketi bu düzeltmeyi içermiyor; depodan kurulum içeriyor.
ee0pdt/Godot-MCP'de Mart 2025'ten beri commit yok. Açık bir issue, WebSocket server'ının kimlik doğrulama olmadan tüm ağ arayüzlerini dinlediğini bildiriyor ve kaynak kodu listen'i yalnızca bir portla çağırıyor; Godot'ta bu her arayüz anlamına gelir. Paylaşılan bir ağda çalıştırmazdık.
Bunlardan herhangi biriyle yapacağımız şeyler:
- Her oturumdan önce commit'leyin. Çoğu server dosyaları doğrudan, editörün geri alma geçmişinin dışında yazar.
- Portu localhost'ta tutun ve token destekleyen server'ları tercih edin; örneğin godot-ai'nin kimlik doğrulamalı WebSocket'i veya Godot-MCP-Native'in isteğe bağlı bearer token'ı.
- Ajanı güvenilmeyen projelere veya varlıklara yönlendirmeyin. Sahne, script ve README'lerdeki metinler modele ulaşır.
- Proje size ait değilse eval tarzı araçları ayrı bir hesapta veya container'da çalıştırın; tugcantopaloglu README'sinin önerdiği gibi.
Çalışmadığı durumlar
| Gördüğünüz | Sunucu | Çözüm |
|---|---|---|
| "Godot Not Found" | Coding-Solo | GODOT_PATH değişkenini Godot çalıştırılabilir dosyasına ayarlayın; macOS'ta uygulama paketinin içindedir |
| "Invalid Project Path" | Coding-Solo | project.godot dosyasını içeren klasörü verin |
| Windows'ta JSON ayrıştırma hataları | Coding-Solo | Komut satırı tırnaklama sorunu; issue 20 ve 49'da bildirilmiş, sürümünüz için o başlıklara bakın |
| Plugin paneli görünmüyor | Plugin sunucuları | Project Settings, Plugins altında plugin'i etkinleştirin, ardından projeyi yeniden yükleyin |
| Düzenleyicide "Disconnected" | Godlink | 6505 portunu başka bir şeyin tutmadığını kontrol edin; istemciyi yeniden başlatın |
| Windows'ta sunucu başlangıçta kapanıyor | godot-ai | Bir Python bağımlılığı sorunu (issue 1165); sorun giderme belgesine bakın |
| UID araçları başarısız oluyor | Coding-Solo | Godot 4.4 veya daha yenisini gerektirirler |
| AI düzenlemeleri geri alınamıyor | Çoğu | git kullanın veya Godlink'in mcp_undo aracını kullanın |
Bir sunucuya gerçek bir projeyle güvenmeden önce onu denetlemek için, burada yaptığımız gibi MCP Inspector CLI ile araçlarını listeleyin ve zararsız birini çağırın. Kataloğumuzdaki Godot sunucuları, checks puanlarıyla birlikte bu sayfanın en üstünde listelenmiştir.