Godot MCP

                           (((((((             (((((((
                        (((((((((((           (((((((((((
                        (((((((((((((       (((((((((((((
                        (((((((((((((((((((((((((((((((((
                        (((((((((((((((((((((((((((((((((
         (((((      (((((((((((((((((((((((((((((((((((((((((      (((((
       (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
     ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
    ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
      (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
        (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         (((((((((((@@@@@@@(((((((((((((((((((((((((((@@@@@@@(((((((((((
         (((((((((@@@@,,,,,@@@(((((((((((((((((((((@@@,,,,,@@@@(((((((((
         ((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((
         ((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((
         (((((((((@@@,,,,,,,@@((((((((@@@@@((((((((@@,,,,,,,@@@(((((((((
         ((((((((((((@@@@@@(((((((((((@@@@@(((((((((((@@@@@@((((((((((((
         (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         @@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@
         ((((((((( @@@(((((((((((@@(((((((((((@@(((((((((((@@@ (((((((((
         (((((((((( @@((((((((((@@@(((((((((((@@@((((((((((@@ ((((((((((
          (((((((((((@@@@@@@@@@@@@@(((((((((((@@@@@@@@@@@@@@(((((((((((
           (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
              (((((((((((((((((((((((((((((((((((((((((((((((((((((
                 (((((((((((((((((((((((((((((((((((((((((((((((
                        (((((((((((((((((((((((((((((((((


                          /$$      /$$  /$$$$$$  /$$$$$$$
                         | $$$    /$$$ /$$__  $$| $$__  $$
                         | $$$$  /$$$$| $$  \__/| $$  \ $$
                         | $$ $$/$$ $$| $$      | $$$$$$$/
                         | $$  $$$| $$| $$      | $$____/
                         | $$\  $ | $$| $$    $$| $$
                         | $$ \/  | $$|  $$$$$$/| $$
                         |__/     |__/ \______/ |__/

Godot oyun motoru ile etkileşim kurmak için bir Model Context Protocol (MCP) sunucusu.

Giriş

Godot MCP, AI ajanlarının Godot editörünü başlatmasını, projeleri çalıştırmasını, hata ayıklama çıktısını yakalamasını ve proje yürütülmesini kontrol etmesini sağlar. Bu doğrudan geri bildirim döngüsü, ajanların gerçek Godot projelerinde neyin çalışıp neyin çalışmadığını anlamasına yardımcı olarak daha iyi kod üretimi ve hata ayıklama desteği sağlar.

Özellikler

• Godot Editörünü Başlat: Belirli bir proje için Godot editörünü aç
• Godot Projelerini Çalıştır: Godot projelerini debug modunda yürüt
• Hata Ayıklama Çıktısını Yakala: Konsol çıktısı ve hata mesajlarını al
• Yürütülmesi Kontrol Et: Godot projelerini programlı olarak başlat ve durdur
• Godot Sürümünü Al: Kurulu Godot sürümünü al
• Godot Projelerini Listele: Belirtilen dizinde Godot projelerini bul
• Proje Analizi: Proje yapısı hakkında ayrıntılı bilgi al
• Sahne Yönetimi:
  • Belirtilen kök düğüm türleriyle yeni sahneler oluştur
  • Mevcut sahnelere özelleştirilebilir özelliklerle düğümler ekle
  • Sprite2D düğümlerine sprite ve dokular yükle
  • 3B sahneleri GridMap için MeshLibrary kaynakları olarak dışa aktar
  • Değişkenler oluşturma seçeneğiyle sahneleri kaydet
• UID Yönetimi (Godot 4.4+ için):
  • Belirli dosyalar için UID'yi al
  • Kaynakları yeniden kaydederek UID referanslarını güncelle

Gereksinimler

• Sisteminizde Godot Engine kurulu
• Node.js (>=18.0.0) ve npm
• MCP'yi destekleyen bir AI ajanı

Hızlı Başlangıç

Claude Code

claude mcp add godot -- npx @coding-solo/godot-mcp

Bu kadar. Claude Code'u yeniden başlat ve Godot MCP araçlarının kullanılabilir olması için bekleniyor.

Ortam değişkenleriyle:

claude mcp add godot -e GODOT_PATH=/path/to/godot -e DEBUG=true -- npx @coding-solo/godot-mcp

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "DEBUG": "true"
      },
      "disabled": false,
      "autoApprove": [
        "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",
        "update_project_uids"
      ]
    }
  }
}

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "DEBUG": "true"
      }
    }
  }
}

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "GODOT_PATH": "/path/to/godot",
        "DEBUG": "true"
      }
    }
  }
}

Ortam Değişkenleri

git clone https://github.com/Coding-Solo/godot-mcp.git
cd godot-mcp
npm install
npm run build

Mimari

Godot MCP sunucusu karmaşık işlemler için paketlenmiş bir GDScript yaklaşımı kullanır:

1. Doğrudan Komutlar: Editörü başlatmak veya proje bilgisi almak gibi basit işlemler Godot'un yerleşik CLI komutlarını doğrudan kullanır.
2. Paketlenmiş İşlemler Betiği: Sahneler oluşturmak veya düğümler eklemek gibi karmaşık işlemler tüm işlemleri yöneten tek ve kapsamlı bir GDScript dosyası (godot_operations.gd) kullanır.

Paketlenmiş betik, işlem türü ve parametreleri JSON olarak kabul ederek her işlem için geçici dosyalar oluşturmadan esnek ve dinamik işlem yürütülmesine izin verir.

Sorun Giderme

• Godot Bulunamadı: GODOT_PATH ortam değişkenini Godot çalıştırılabilir dosyasının yoluna ayarlayın
• Bağlantı Sorunları: Sunucunun çalıştığından emin olun ve AI asistanınızı yeniden başlatın
• Geçersiz Proje Yolu: Yolun project.godot dosyası içeren bir dizine işaret ettiğinden emin olun
• İnşa Sorunları: npm install komutunu çalıştırarak tüm bağımlılıkların kurulduğundan emin olun

Lisans

Bu proje MIT Lisansı altında lisanslanmıştır - ayrıntılar için LICENSE dosyasına bakın.