MCP Unity Editörü (Oyun Motoru)

                              ,/(/.   *(/,                                  
                          */(((((/.   *((((((*.                             
                     .*((((((((((/.   *((((((((((/.                         
                 ./((((((((((((((/    *((((((((((((((/,                     
             ,/(((((((((((((/*.           */(((((((((((((/*.                
            ,%%#((/((((((*                    ,/(((((/(#&@@(                
            ,%%##%%##((((((/*.             ,/((((/(#&@@@@@@(                
            ,%%######%%##((/(((/*.    .*/(((//(%@@@@@@@@@@@(                
            ,%%####%#(%%#%%##((/((((((((//#&@@@@@@&@@@@@@@@(                
            ,%%####%(    /#%#%%%##(//(#@@@@@@@%,   #@@@@@@@(                
            ,%%####%(        *#%###%@@@@@@(        #@@@@@@@(                
            ,%%####%(           #%#%@@@@,          #@@@@@@@(                
            ,%%##%%%(           #%#%@@@@,          #@@@@@@@(                
            ,%%%#*              #%#%@@@@,             *%@@@(                
            .,      ,/##*.      #%#%@@@@,     ./&@#*      *`                
                ,/#%#####%%#/,  #%#%@@@@, ,/&@@@@@@@@@&\.                    
                 `*#########%%%%###%@@@@@@@@@@@@@@@@@@&*´                   
                    `*%%###########%@@@@@@@@@@@@@@&*´                        
                        `*%%%######%@@@@@@@@@@&*´                            
                            `*#%%##%@@@@@&*´                                 
                               `*%#%@&*´                                     
                                                       
     ███╗   ███╗ ██████╗██████╗         ██╗   ██╗███╗   ██╗██╗████████╗██╗   ██╗
     ████╗ ████║██╔════╝██╔══██╗        ██║   ██║████╗  ██║██║╚══██╔══╝╚██╗ ██╔╝
     ██╔████╔██║██║     ██████╔╝        ██║   ██║██╔██╗ ██║██║   ██║    ╚████╔╝ 
     ██║╚██╔╝██║██║     ██╔═══╝         ██║   ██║██║╚██╗██║██║   ██║     ╚██╔╝  
     ██║ ╚═╝ ██║╚██████╗██║             ╚██████╔╝██║ ╚████║██║   ██║      ██║   
     ╚═╝     ╚═╝ ╚═════╝╚═╝              ╚═════╝ ╚═╝  ╚═══╝╚═╝   ╚═╝      ╚═╝   

MCP Unity, Unity Editörü için Model Context Protocol uygulamasıdır ve AI asistanlarının Unity projelerinizle etkileşim kurmasını sağlar. Bu paket, Unity ile MCP protokolünü uygulayan bir Node.js sunucusu arasında bir köprü sağlar ve Cursor, Windsurf, Claude Code, Codex CLI, GitHub Copilot, Google Antigravity ve OpenCode gibi AI ajanlarının Unity Editörü içinde işlem yürütmesini sağlar.

Özellikler

IDE Entegrasyonu - Paket Önbelleği Erişimi

MCP Unity, VSCode benzeri IDEler (Visual Studio Code, Cursor, Windsurf, Google Antigravity) ile otomatik entegrasyon sağlar ve Unity Library/PackedCache klasörünü çalışma alanınıza ekler. Bu özellik:

• Unity paketleri için kod zekasını iyileştirir
• Unity paketleri için daha iyi otomatik tamamlama ve tür bilgisi sağlar
• AI kodlama asistanlarının projenizin bağımlılıklarını anlamasına yardımcı olur

MCP Sunucu Araçları

Aşağıdaki araçlar MCP aracılığıyla Unity sahneleri ve GameObjects'i manipüle etme ve sorgulama için kullanılabilir:

• execute_menu_item: Unity menü öğelerini çalıştırır (MenuItem özniteliği ile etiketlenmiş fonksiyonlar)

  Örnek istem: "Yeni boş bir GameObject oluşturmak için 'GameObject/Create Empty' menü öğesini çalıştır"

• select_gameobject: GameObject'leri hiyerarşide yol veya örnek kimliğine göre seçer

  Örnek istem: "Sahnemizdeki Main Camera nesnesini seç"

• update_gameobject: GameObject'in temel özelliklerini günceller (ad, etiket, katman, aktif/statik durumu) veya yoksa GameObject oluşturur

  Örnek istem: "Player nesnesinin etiketini 'Enemy' olarak ayarla ve onu deaktif yap"

• update_component: GameObject'teki bileşen alanlarını günceller veya GameObject'te yoksa bileşeni ekler

  Örnek istem: "Player nesnesine Rigidbody bileşeni ekle ve kütlesini 5 olarak ayarla"

• add_package: Unity Package Manager'da yeni paketler yükler

  Örnek istem: "TextMeshPro paketini projeme ekle"

• run_tests: Unity Test Runner kullanarak testleri çalıştırır

  Örnek istem: "Projemizdeki tüm EditMode testlerini çalıştır"

• send_console_log: Unity'ye konsol günlüğü gönderir

  Örnek istem: "Unity Editörüne bir konsol günlüğü gönder"

• add_asset_to_scene: AssetDatabase'deki bir varlığı Unity sahnesine ekler

  Örnek istem: "Player prefab'ini projemden mevcut sahneye ekle"

• create_prefab: İsteğe bağlı MonoBehaviour script ve serialized alan değerleri ile bir prefab oluşturur

  Örnek istem: "'PlayerController' script'inden 'Player' adlı bir prefab oluştur"

• create_scene: Yeni bir sahne oluşturur ve belirtilen yola kaydeder

  Örnek istem: "Scenes klasöründe 'Level1' adlı yeni bir sahne oluştur"

• load_scene: Bir sahneyi yol veya ada göre yükler, isteğe bağlı olarak eklemeli yükleme ile

  Örnek istem: "MainMenu sahnesi yükle"

• delete_scene: Bir sahneyi yol veya ada göre siler ve Build Settings'ten kaldırır

  Örnek istem: "Eski TestScene'i projemden sil"

• get_gameobject: Tüm bileşenleri içeren belirli bir GameObject hakkında ayrıntılı bilgi alır

  Örnek istem: "Player GameObject'inin ayrıntılarını al"

• get_console_logs: Sayfalandırma desteği ile Unity konsolundan günlükleri alır

  Örnek istem: "Unity konsolundan son 20 hata günlüğünü göster"

• recompile_scripts: Unity projesindeki tüm script'leri yeniden derler

  Örnek istem: "Unity projemizdeki script'leri yeniden derle"

• save_scene: Mevcut etkin sahneyi kaydeder, isteğe bağlı olarak yeni yola Farklı Kaydet ile

  Örnek istem: "Mevcut sahneyi kaydet" veya "Sahneyi 'Assets/Scenes/Level2.unity' olarak kaydet"

• get_scene_info: Etkin sahne hakkında bilgi alır: ad, yol, dirty durumu ve yüklü tüm sahneler

  Örnek istem: "Projemde şu anda hangi sahneler yüklü?"

• unload_scene: Bir sahneyi hiyerarşiden boşaltır (sahne varlığını silmez)

  Örnek istem: "UI sahnesi hiyerarşiden boşalt"

• duplicate_gameobject: Sahnede isteğe bağlı yeniden adlandırma ve yeniden ebeveynleştirme ile bir GameObject'i kopyalar

  Örnek istem: "Enemy prefab'ini 5 kez kopyala ve Enemy_1 ile Enemy_5 arasında adlandır"

• delete_gameobject: Sahnesinden bir GameObject'i siler

  Örnek istem: "Eski Player nesnesini sahnesinden sil"

• reparent_gameobject: Hiyerarşideki GameObject'in ebeveynini değiştirir

  Örnek istem: "HealthBar nesnesini UI Canvas'ının alt öğesi olacak şekilde taşı"

• move_gameobject: Bir GameObject'i yeni bir konuma taşır (yerel veya dünya alanı)

  Örnek istem: "Player nesnesini dünya alanında (10, 0, 5) konumuna taşı"

• rotate_gameobject: Bir GameObject'i yeni bir rotasyona döndürür (yerel veya dünya alanı, Euler açıları veya quaternion)

  Örnek istem: "Kamerayı Y ekseni üzerinde 45 derece döndür"

• scale_gameobject: Bir GameObject'i yeni bir yerel ölçeğe ölçeklendir

  Örnek istem: "Enemy nesnesini boyutunun iki katına ölçeklendir"

• set_transform: Bir GameObject'in konumunu, rotasyonunu ve ölçeğini tek bir işlemde ayarlar

  Örnek istem: "Cube'ün konumunu (0, 5, 0), rotasyonunu (0, 90, 0) ve ölçeğini (2, 2, 2) olarak ayarla"

• create_material: Belirtilen shader ile yeni bir materyal oluşturur ve projeye kaydeder

  Örnek istem: "URP Lit shader kullanarak 'EnemyMaterial' adlı kırmızı bir materyal oluştur"

• assign_material: Bir GameObject'in Renderer bileşenine bir materyal atar

  Örnek istem: "'EnemyMaterial'ı Enemy GameObject'ine ata"

• modify_material: Mevcut bir materyalin özelliklerini değiştirir (renkler, float'lar, dokular)

  Örnek istem: "'EnemyMaterial'ın rengini mavi olarak değiştir ve metalik'i 0.8 olarak ayarla"

• get_material_info: Shader ve tüm özellikleri içeren materyal hakkında ayrıntılı bilgi alır

  Örnek istem: "'PlayerMaterial'ın tüm özelliklerini göster"

• batch_execute: Birden fazla araç işlemini tek bir batch istekte çalıştırır, tur sayısını azaltır ve başarısızlık durumunda isteğe bağlı geri alma ile atomic işlemleri sağlar

  Örnek istem: "Enemy_1 ile Enemy_10 arasında adlandırılmış 10 boş GameObject'i tek bir batch işleminde oluştur"

MCP Sunucu Kaynakları

• unity://menu-items: execute_menu_item aracını kolaylaştırmak için Unity Editörü'ndeki tüm kullanılabilir menü öğelerinin bir listesini alır

  Örnek istem: "GameObject oluşturma ile ilgili tüm kullanılabilir menü öğelerini göster"

• unity://scenes-hierarchy: Mevcut Unity sahne hiyerarşisindeki tüm game objects'in bir listesini alır

  Örnek istem: "Geçerli sahneler hiyerarşi yapısını göster"

• unity://gameobject/{id}: Örnek kimliğine veya sahne hiyerarşisindeki nesne yoluna göre belirli bir GameObject hakkında ayrıntılı bilgi alır; tüm GameObject bileşenleri ile serialized özellikler ve alanları içerir

  Örnek istem: "Player GameObject hakkında ayrıntılı bilgi al"

• unity://logs: Unity konsolundaki tüm günlüklerin bir listesini alır

  Örnek istem: "Unity konsolundan son hata mesajlarını göster"

• unity://packages: Unity Package Manager'dan yüklü ve kullanılabilir paketler hakkında bilgi alır

  Örnek istem: "Unity projemde şu anda yüklü olan tüm paketleri listele"

• unity://assets: Unity Asset Database'deki varlıklar hakkında bilgi alır

  Örnek istem: "Projemde tüm doku varlıklarını bul"

• unity://tests/{testMode}: Unity Test Runner'daki testler hakkında bilgi alır

  Örnek istem: "Unity projemizdeki tüm kullanılabilir testleri listele"

Gereksinimler

• Unity 6 veya daha yeni - sunucuyu yüklemek için
• Node.js 18 veya daha yeni - sunucuyu başlatmak için
• npm 9 veya daha yeni - sunucuyu hata ayıklamak için

[!NOTE] Boşluk İçeren Proje Yolları

MCP Unity boşluk içeren proje yollarını destekler. Ancak bağlantı sorunları yaşıyorsanız, sorun giderme adımı olarak projenizi boşluk olmayan bir yola taşımayı deneyin.

Örnekler:

• ✅ Önerilen: C:\Users\YourUser\Documents\UnityProjects\MyAwesomeGame
• ✅ Desteklenen: C:\Users\Your User\Documents\Unity Projects\My Awesome Game

Kurulum

MCP Unity Server'ı yüklemek çok adımlı bir işlemdir:

Adım 1: Node.js'i yükle

MCP Unity sunucusunu çalıştırmak için, bilgisayarınızda Node.js 18 veya daha yeni bir sürüm yüklü olmalıdır:

Adım 2: Unity MCP Server paketini Unity Package Manager aracılığıyla yükle

1. Unity Package Manager'ı aç (Window > Package Manager)
2. Sol üst köşedeki "+" düğmesini tıkla
3. "Add package from git URL..." seçeneğini belirle
4. Şu komutu gir: https://github.com/CoderGamester/mcp-unity.git
5. "Add" butonuna tıkla

Adım 3: AI LLM İstemcisini Yapılandır

{
   "mcpServers": {
       "mcp-unity": {
          "command": "node",
          "args": [
             "ABSOLUTE/PATH/TO/mcp-unity/Server~/build/index.js"
          ]
       }
   }
}

{
   "mcpServers": {
       "mcp-unity": {
          "command": "node",
          "args": [
             "${workspaceFolder}/Library/PackageCache/com.gamelovers.mcp-unity@<hash>/Server~/build/index.js"
          ]
       }
   }
}

[mcp_servers.mcp-unity]
command = "node"
args = ["ABSOLUTE/PATH/TO/mcp-unity/Server~/build/index.js"]

{
   "mcpServers": {
       "mcp-unity": {
          "command": "node",
          "args": [
             "Library/PackageCache/com.gamelovers.mcp-unity@<hash>/Server~/build/index.js"
          ]
       }
   }
}

{
   "mcpServers": {
       "mcp-unity": {
          "command": "node",
          "args": [
             "Library/PackageCache/com.gamelovers.mcp-unity@<hash>/Server~/build/index.js"
          ]
       }
   }
}

[mcp_servers.mcp-unity]
command = "node"
args = ["Library/PackageCache/com.gamelovers.mcp-unity@<hash>/Server~/build/index.js"]

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mcp-unity": {
      "type": "local",
      "enabled": true,
      "command": ["node", "Library/PackageCache/com.gamelovers.mcp-unity@<hash>/Server~/build/index.js"],
      "environment": {}
    }
  }
}

Unity Editörü MCP Sunucusunu Başlat

1. Unity Editörü'nü aç
2. Tools > MCP Unity > Server Window'a git
3. WebSocket sunucusunu başlatmak için "Start Server" düğmesine tıkla
4. AI Kodlama IDE'nizi açın (ör. Cursor, Windsurf, Claude Code, Codex CLI, GitHub Copilot, Google Antigravity, OpenCode, vb.) ve Unity araçlarını çalıştırmaya başlayın

AI istemcisi WebSocket sunucusuna bağlanırken, penceredeki yeşil kutuda otomatik olarak gösterilir

İsteğe Bağlı: WebSocket Bağlantı Noktasını Ayarla

Varsayılan olarak, WebSocket sunucusu '8090' bağlantı noktasında çalışır. Bu bağlantı noktasını iki şekilde değiştirebilirsiniz:

1. Unity Editörü'nü aç
2. Tools > MCP Unity > Server Window'a git
3. "WebSocket Port" değerini istenen bağlantı noktası numarasına değiştir
4. Unity UNITY_PORT sistem ortam değişkenini yeni bağlantı noktası numarasına ayarlar
5. Node.js sunucusunu yeniden başlat
6. Unity Editörü web soketini Node.js MCP Sunucusuna yeniden bağlanmak için "Start Server"'ı tekrar tıkla

İsteğe Bağlı: Zaman Aşımını Ayarla

Varsayılan olarak, MCP sunucusu ile WebSocket arasındaki zaman aşımı 10 saniyedir. Kullandığınız işletim sistemine bağlı olarak değiştirebilirsiniz:

1. Unity Editörü'nü aç
2. Tools > MCP Unity > Server Window'a git
3. "Request Timeout (seconds)" değerini istenen zaman aşımı saniyesine değiştir
4. Unity UNITY_REQUEST_TIMEOUT sistem ortam değişkenini yeni zaman aşımı değerine ayarlar
5. Node.js sunucusunu yeniden başlat
6. Unity Editörü web soketini Node.js MCP Sunucusuna yeniden bağlanmak için "Start Server"'ı tekrar tıkla

[!TIP]
AI Kodlama IDE'niz (ör. Claude Desktop, Cursor IDE, Windsurf IDE) ile MCP Sunucusu arasındaki zaman aşımı IDE'ye bağlıdır.

İsteğe Bağlı: Uzak MCP Köprüsü Bağlantılarına İzin Ver

Varsayılan olarak, WebSocket sunucusu 'localhost' üzerine bağlanır. Diğer makinelerden MCP köprüsü bağlantılarına izin vermek için:

1. Unity Editörü'nü aç
2. Tools > MCP Unity > Server Window'a git
3. "Allow Remote Connections" onay kutusunu etkinleştir
4. Unity WebSocket sunucusunu '0.0.0.0' (tüm arayüzleri) üzerine bağlar
5. Yeni host yapılandırmasını uygulamak için Node.js sunucusunu yeniden başlat
6. MCP köprüsünü uzaktan çalıştırırken UNITY_HOST ortam değişkenini Unity makinenizin IP adresine ayarla: UNITY_HOST=192.168.1.100 node server.js

Sunucuyu Hata Ayıklama