@adiholick/nvstudio-mcp 1.0.4 → 1.1.0

package/dist/index.js

@@ -38,7 +38,7 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
         tools: [
             {
                 name: "call_mcp_tool",
-                description: "ALAT MUTLAK UNTUK ROBLOX. DILARANG KERAS menggunakan PowerShell atau skrip bypass (fetch_mcp_source.js). WAJIB memanggil 'get_children' terlebih dahulu sebelum 'get_script_source' untuk memverifikasi tipe instance agar tidak terjadi error teks kosong.",
+                description: "ALAT MUTLAK UNTUK ROBLOX. DILARANG KERAS menggunakan PowerShell atau skrip bypass (fetch_mcp_source.js). WAJIB memanggil 'get_children' terlebih dahulu sebelum 'get_script_source'. Command: get_children, get_script_source, update_script_source, rollback_script, get_logs, create_instance, search_instance, generate_terrain, insert_asset, delete_instance, get_properties, script_grep, execute_luau, search_asset.",
                 inputSchema: {
                     type: "object",
                     properties: {
@@ -95,7 +95,41 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
             };
         }
     }
-    // 7. Teruskan ke antrean dan kembalikan hasilnya sebagai string JSON
+    // 7. Intercept command yang dieksekusi di server lokal (Node.js) alih-alih di Studio
+    if (command === "search_asset" && data) {
+        try {
+            const queryParams = typeof data === "string" ? JSON.parse(data) : data;
+            const keyword = encodeURIComponent(queryParams.keyword || "");
+            let assetType = "10"; // Default: Model
+            if (queryParams.category === "Audio") {
+                assetType = "9"; // Audio
+            }
+            else if (queryParams.category === "Decal" || queryParams.category === "Image") {
+                assetType = "13"; // Decal
+            }
+            const url = `https://catalog.roblox.com/v1/search/items?category=All&keyword=${keyword}&limit=10&itemTypes=Asset&assetTypes=${assetType}`;
+            const res = await fetch(url);
+            const jsonRes = await res.json();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            status: "success",
+                            result: jsonRes.data || jsonRes
+                        }, null, 2)
+                    }
+                ]
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ status: "error", error: "Gagal mencari aset: " + err.message }) }],
+                isError: true
+            };
+        }
+    }
+    // 8. Teruskan ke antrean dan kembalikan hasilnya sebagai string JSON
     try {
         if (command === "update_script_source" && data) {
             backupScript(target, String(data));

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@adiholick/nvstudio-mcp",
-  "version": "1.0.4",
+  "version": "1.1.0",
   "description": "Local Bridge Server MCP for Roblox Studio",
   "main": "dist/index.js",
   "bin": "dist/index.js",
   "files": [
     "dist",
-    "public"
+    "public",
+    "studio-plugin"
   ],
   "scripts": {
     "build": "tsc",

package/studio-plugin/Main.server.lua

@@ -0,0 +1,291 @@
+local HttpService = game:GetService("HttpService")
+local LogService = game:GetService("LogService")
+
+local TASK_URL = "http://localhost:3055/api/tasks"
+local RESPONSE_URL = "http://localhost:3055/api/response"
+
+-- Generate Unique Studio ID (menghindari bentrok jika 2 Studio terbuka)
+local STUDIO_ID = HttpService:GenerateGUID(false)
+
+-- Import UI Manager (Procedural Dashboard)
+local uiModule = script.Parent:FindFirstChild("ui_manager")
+local ui = nil
+
+-- Membangun Tombol Toolbar (Toggle)
+local toolbar = plugin:CreateToolbar("NVStudio MCP")
+local toggleBtn = toolbar:CreateButton("Dashboard", "Buka Dashboard NVStudio MCP", "rbxassetid://82696893597722")
+
+-- Global State & Context AI
+local ctx = {
+    scriptHistory = {},
+    recentLogs = {},
+    HttpService = HttpService,
+    studioId = STUDIO_ID
+}
+local MAX_LOGS = 50
+local isConnected = false
+local autoConnect = plugin:GetSetting("AutoConnect") or false
+local isPolling = false
+local isClickDebounce = false -- Mencegah rapid double-click
+
+-- Deklarasi fungsi polling di awal agar bisa dipanggil oleh UI
+local startPolling
+local stopPolling
+
+-- Inisialisasi UI jika modul ditemukan
+if uiModule then
+    local UIManager = require(uiModule)
+    ui = UIManager.init(plugin, STUDIO_ID)
+    
+    -- Sync Initial State ke UI
+    ui:setAutoConnectState(autoConnect)
+    ui:setStatus("disconnected")
+    
+    -- Event Toggle GUI Panel
+    toggleBtn.Click:Connect(function()
+        ui:toggleVisibility()
+    end)
+    
+    -- Event Tombol Connect (dengan debounce untuk mencegah double-click)
+    ui.connectBtn.MouseButton1Click:Connect(function()
+        if isClickDebounce then return end
+        isClickDebounce = true
+        
+        if not isConnected then
+            -- CONNECT (manual) — reset manual disconnect flag agar auto-detect bisa bekerja
+            isManualDisconnect = false
+            isConnected = true
+            ui:setStatus("waiting")
+            ui:addLog("[System] Koneksi manual dimulai. Mencari AI Server (Waiting)...", Color3.fromRGB(255, 220, 100))
+            startPolling()
+        else
+            -- DISCONNECT — hentikan polling dan tandai manual disconnect
+            stopPolling()
+            ui:setStatus("disconnected")
+            ui:addLog("[System] Koneksi dihentikan oleh pengguna.", Color3.fromRGB(255, 100, 100))
+        end
+        
+        task.delay(0.3, function()
+            isClickDebounce = false
+        end)
+    end)
+    
+    -- Event Custom Checkbox (Auto-Connect)
+    ui.autoConnectBtn.MouseButton1Click:Connect(function()
+        autoConnect = not autoConnect
+        plugin:SetSetting("AutoConnect", autoConnect)
+        ui:setAutoConnectState(autoConnect)
+        ui:addLog("[System] Preferensi Auto-Connect disimpan: " .. tostring(autoConnect), Color3.fromRGB(200, 200, 255))
+    end)
+else
+    -- Fallback aman jika pengguna lupa meng-copy ui_manager.lua
+    toggleBtn.Click:Connect(function()
+        print("[NVStudio MCP] ERROR: Modul 'ui_manager' tidak ditemukan di dalam Folder. GUI Gagal dimuat!")
+    end)
+end
+
+-- Handler Output Studio (Untuk AI dan GUI)
+local function addSystemLog(msg, msgType)
+    local color = Color3.fromRGB(200, 200, 200)
+    local prefix = "[INFO] "
+    if msgType == Enum.MessageType.MessageError then
+        prefix = "[ERROR] "
+        color = Color3.fromRGB(255, 100, 100)
+    elseif msgType == Enum.MessageType.MessageWarning then
+        prefix = "[WARN] "
+        color = Color3.fromRGB(255, 200, 100)
+    end
+    
+    local fullMsg = prefix .. msg
+    
+    -- 1. Simpan di memori untuk disedot AI
+    table.insert(ctx.recentLogs, fullMsg)
+    if #ctx.recentLogs > MAX_LOGS then
+        table.remove(ctx.recentLogs, 1)
+    end
+    
+    -- 2. Cetak ke Terminal GUI Plugin
+    if ui then
+        ui:addLog(fullMsg, color)
+    end
+end
+
+-- Ikat listener output
+LogService.MessageOut:Connect(addSystemLog)
+
+-- Memuat semua module skills secara dinamis
+local skills = {}
+for _, module in ipairs(script.Parent:GetChildren()) do
+    if module:IsA("ModuleScript") and module.Name ~= "ui_manager" then
+        skills[module.Name] = require(module)
+    end
+end
+
+-- Fungsi Helper Pathing
+local function getInstanceFromPath(pathString)
+    local parts = string.split(pathString, ".")
+    local current = game
+    
+    if parts[1] == "game" then table.remove(parts, 1) end
+    
+    for _, part in ipairs(parts) do
+        local found = current:FindFirstChild(part)
+        if not found then return nil end
+        current = found
+    end
+    return current
+end
+
+-- Memproses Task Eksekusi dari AI
+local function processTask(taskData)
+    if not taskData or not taskData.id or not taskData.command then return nil end
+    
+    if ui then 
+        ui:addLog("[AI Command] Menerima instruksi: " .. taskData.command, Color3.fromRGB(150, 200, 255)) 
+    end
+    
+    local targetInstance = getInstanceFromPath(taskData.target)
+    if not targetInstance then
+        return {
+            id = taskData.id,
+            status = "error",
+            error = "Target path tidak ditemukan: " .. taskData.target
+        }
+    end
+
+    local skillFunc = skills[taskData.command]
+    if not skillFunc then
+        return {
+            id = taskData.id,
+            status = "error",
+            error = "Command tidak dikenali oleh Studio: " .. taskData.command
+        }
+    end
+
+    -- Eksekusi skill AI
+    local result = skillFunc(targetInstance, taskData.data, ctx, taskData.target)
+    result.id = taskData.id
+    
+    -- Cetak hasil eksekusi ke Terminal GUI
+    if ui then
+        local color = result.status == "success" and Color3.fromRGB(100, 255, 100) or Color3.fromRGB(255, 100, 100)
+        ui:addLog("[AI Result] " .. tostring(result.result or result.error), color)
+    end
+    
+    return result
+end
+
+-- Menghentikan polling dengan bersih (dipanggil oleh tombol Disconnect)
+local isManualDisconnect = false -- Mencegah auto-reconnect saat user sengaja disconnect
+
+function stopPolling()
+    isConnected = false
+    isManualDisconnect = true
+    -- isPolling akan menjadi false secara otomatis saat loop keluar
+end
+
+-- Background Polling Loop (Dapat dihentikan oleh user)
+function startPolling()
+    if isPolling then return end
+    isPolling = true
+    
+    task.spawn(function()
+        while isConnected do
+            local success, response = pcall(function()
+                -- Tambahkan cache-buster agar Studio tidak me-cache response HTTP
+                local cacheBuster = "?t=" .. tostring(os.clock())
+                return HttpService:GetAsync(TASK_URL .. cacheBuster)
+            end)
+
+            -- PENTING: Cek ulang isConnected SETELAH HTTP request selesai.
+            -- Jika user menekan Disconnect saat request sedang berjalan,
+            -- kita TIDAK boleh menimpa status UI "disconnected" yang sudah di-set.
+            if not isConnected then
+                break
+            end
+
+            if success and response then
+                -- JIKA PING SUKSES, Node.js menyala (IDE / Agen Sedang Terbuka!)
+                if ui then ui:setStatus("connected") end
+
+                local decodeSuccess, taskData = pcall(function()
+                    return HttpService:JSONDecode(response)
+                end)
+                
+                if decodeSuccess and taskData and taskData.id then
+                    local resultData = processTask(taskData)
+                    if resultData then
+                        pcall(function()
+                            local jsonResult = HttpService:JSONEncode(resultData)
+                            HttpService:PostAsync(RESPONSE_URL, jsonResult, Enum.HttpContentType.ApplicationJson)
+                        end)
+                    end
+                end
+            else
+                -- Fetch gagal (Node.js server mati karena IDE/Antigravity/Cursor ditutup)
+                if ui then ui:setStatus("waiting") end
+            end
+            
+            -- Cek lagi sebelum sleep (agar disconnect lebih responsif)
+            if not isConnected then
+                break
+            end
+            task.wait(1)
+        end
+        isPolling = false
+    end)
+end
+
+-- ══════════════════════════════════════════════════════════════════════
+-- AUTO-DETECT: Background heartbeat yang SELALU berjalan.
+-- Mendeteksi apakah server MCP aktif setiap 2 detik.
+-- Jika terdeteksi aktif → otomatis connect (tanpa perlu tekan tombol).
+-- Jika terdeteksi mati → otomatis update status.
+-- ══════════════════════════════════════════════════════════════════════
+task.spawn(function()
+    task.wait(1) -- Tunggu sebentar agar UI siap
+    
+    if ui then
+        ui:addLog("[System] Plugin termuat. Auto-detect server MCP aktif...", Color3.fromRGB(200, 200, 200))
+    end
+    
+    while true do
+        -- Skip heartbeat jika polling loop sudah aktif (ia sudah menangani semuanya)
+        if not isPolling then
+            local success, errorMsg = pcall(function()
+                local cacheBuster = "?t=" .. tostring(os.clock())
+                return HttpService:GetAsync(TASK_URL .. cacheBuster)
+            end)
+            
+            if success then
+                -- Server terdeteksi aktif!
+                if not isConnected and not isManualDisconnect then
+                    isConnected = true
+                    if ui then
+                        ui:setStatus("connected")
+                        ui:addLog("[System] Server MCP terdeteksi! Auto-connected.", Color3.fromRGB(100, 255, 100))
+                    end
+                    startPolling()
+                end
+            else
+                -- Server tidak aktif
+                if isConnected then
+                    -- Server baru saja mati (sebelumnya connected) — polling loop juga akan exit
+                    isConnected = false
+                    if ui then
+                        ui:setStatus("waiting")
+                        ui:addLog("[System] Server MCP terputus. Menunggu reconnect...", Color3.fromRGB(255, 200, 100))
+                    end
+                elseif not isManualDisconnect then
+                    if ui then 
+                        ui:setStatus("waiting") 
+                        -- HANYA print error jika belum terkoneksi, untuk debugging
+                        ui:addLog("[Debug] Deteksi gagal: " .. tostring(errorMsg), Color3.fromRGB(150, 150, 150))
+                    end
+                end
+            end
+        end
+        
+        task.wait(2)
+    end
+end)

package/studio-plugin/create_instance.lua

@@ -0,0 +1,24 @@
+return function(targetInstance, data, ctx, targetPath)
+    local success, config = pcall(function() return ctx.HttpService:JSONDecode(data) end)
+    if not success or not config.ClassName then
+        return { status = "error", error = "Format data JSON tidak valid atau ClassName hilang." }
+    end
+    
+    local newSuccess, newInst = pcall(function()
+        local inst = Instance.new(config.ClassName)
+        inst.Parent = targetInstance
+        
+        if config.Properties then
+            for prop, val in pairs(config.Properties) do
+                pcall(function() inst[prop] = val end)
+            end
+        end
+        return inst
+    end)
+    
+    if newSuccess then
+        return { status = "success", result = "Instance '"..config.ClassName.."' berhasil dibuat di " .. targetPath }
+    else
+        return { status = "error", error = "Gagal membuat Instance. Pastikan ClassName valid." }
+    end
+end

package/studio-plugin/delete_instance.lua

@@ -0,0 +1,31 @@
+return function(targetInstance, data, ctx, targetPath)
+    -- Guardrail: Cegah penghapusan Service utama
+    local protectedServices = {
+        "Workspace", "Players", "Lighting", "MaterialService", "NetworkClient", 
+        "ReplicatedFirst", "ReplicatedStorage", "ServerScriptService", "ServerStorage", 
+        "StarterGui", "StarterPack", "StarterPlayer", "Teams", "SoundService", "Chat", 
+        "TextChatService", "VoiceChatService"
+    }
+    
+    if targetInstance.Parent == game or targetInstance.Parent == nil then
+        for _, serviceName in ipairs(protectedServices) do
+            if targetInstance.Name == serviceName or targetInstance.ClassName == serviceName then
+                return { status = "error", error = "GUARDRAIL BLOCKED: Anda tidak diizinkan untuk menghapus layanan tingkat atas (" .. targetInstance.Name .. ")." }
+            end
+        end
+    end
+    
+    local name = targetInstance.Name
+    local className = targetInstance.ClassName
+    local parentName = targetInstance.Parent and targetInstance.Parent.Name or "nil"
+    
+    local success, err = pcall(function()
+        targetInstance:Destroy()
+    end)
+    
+    if success then
+        return { status = "success", result = "Instance '" .. name .. "' (" .. className .. ") berhasil dihapus dari " .. parentName .. "." }
+    else
+        return { status = "error", error = "Gagal menghapus instance: " .. tostring(err) }
+    end
+end

package/studio-plugin/execute_luau.lua

@@ -0,0 +1,71 @@
+return function(targetInstance, data, ctx, targetPath)
+    local code = data
+    if not code or code == "" then
+        return { status = "error", error = "Kode yang dieksekusi tidak boleh kosong." }
+    end
+    
+    local HttpService = game:GetService("HttpService")
+    
+    -- Bungkus code ke dalam fungsi return
+    local wrappedCode = "return function()\n" .. code .. "\nend"
+    
+    local moduleScript = Instance.new("ModuleScript")
+    moduleScript.Name = "AI_Execute_Temp"
+    moduleScript.Source = wrappedCode
+    
+    -- Taruh di ReplicatedStorage sementara agar bisa di-require
+    moduleScript.Parent = game:GetService("ReplicatedStorage")
+    
+    local resultData = nil
+    local execError = nil
+    local isFinished = false
+    
+    -- Eksekusi asinkron dengan batas waktu (timeout) 5 detik
+    task.spawn(function()
+        local reqSuccess, func = pcall(function() return require(moduleScript) end)
+        if reqSuccess and type(func) == "function" then
+            local execSuccess, res = pcall(func)
+            if execSuccess then
+                resultData = res
+            else
+                execError = "Runtime Error: " .. tostring(res)
+            end
+        else
+            execError = "Syntax/Require Error: " .. tostring(func)
+        end
+        isFinished = true
+    end)
+    
+    -- Tunggu hingga 5 detik
+    local timeWaited = 0
+    while not isFinished and timeWaited < 5 do
+        timeWaited = timeWaited + task.wait()
+    end
+    
+    -- Pembersihan (Wajib dihancurkan)
+    pcall(function() moduleScript:Destroy() end)
+    
+    if not isFinished then
+        return { status = "error", error = "Timeout 5 detik terlampaui. Kemungkinan ada infinite loop tanpa task.wait()." }
+    end
+    
+    if execError then
+        return { status = "error", error = execError }
+    end
+    
+    -- Cegah return nil error
+    if resultData == nil then
+        return { status = "success", result = "Eksekusi berhasil (Tidak ada nilai kembalian)." }
+    end
+    
+    -- JSON Encode untuk mencegah raw Instance return crash
+    local serializeSuccess, jsonRes = pcall(function()
+        return HttpService:JSONEncode(resultData)
+    end)
+    
+    if serializeSuccess then
+        return { status = "success", result = HttpService:JSONDecode(jsonRes) } -- decode kembali agar format aslinya diteruskan oleh router
+    else
+        return { status = "error", error = "Gagal menserialisasi hasil (Dilarang mengembalikan raw Roblox Instance): " .. tostring(jsonRes) }
+    end
+end

package/studio-plugin/generate_terrain.lua

@@ -0,0 +1,23 @@
+return function(targetInstance, data, ctx, targetPath)
+    local success, config = pcall(function() return ctx.HttpService:JSONDecode(data) end)
+    if not success or not config.Size or not config.Position or not config.Material then
+        return { status = "error", error = "Format JSON tidak valid. Membutuhkan Size, Position, dan Material." }
+    end
+    
+    local fillSuccess, err = pcall(function()
+        local terrain = game.Workspace.Terrain
+        local materialEnum = Enum.Material[config.Material] or Enum.Material.Grass
+        
+        local size = Vector3.new(config.Size[1], config.Size[2], config.Size[3])
+        local position = Vector3.new(config.Position[1], config.Position[2], config.Position[3])
+        
+        local region = Region3.new(position - (size/2), position + (size/2))
+        terrain:FillRegion(region:ExpandToGrid(4), 4, materialEnum)
+    end)
+    
+    if fillSuccess then
+        return { status = "success", result = "Terrain (" .. config.Material .. ") berhasil di-generate." }
+    else
+        return { status = "error", error = "Gagal men-generate Terrain. Pastikan tipe data array angka valid: " .. tostring(err) }
+    end
+end

package/studio-plugin/get_children.lua

@@ -0,0 +1,7 @@
+return function(targetInstance, data, ctx, targetPath)
+    local children = {}
+    for _, child in ipairs(targetInstance:GetChildren()) do
+        table.insert(children, child.Name .. " (" .. child.ClassName .. ")")
+    end
+    return { status = "success", result = children }
+end

package/studio-plugin/get_logs.lua

@@ -0,0 +1,7 @@
+return function(targetInstance, data, ctx, targetPath)
+    if #ctx.recentLogs == 0 then
+        return { status = "success", result = {"Console kosong. Tidak ada error atau log terbaru."} }
+    else
+        return { status = "success", result = ctx.recentLogs }
+    end
+end

package/studio-plugin/get_properties.lua

@@ -0,0 +1,52 @@
+return function(targetInstance, data, ctx, targetPath)
+    local CollectionService = game:GetService("CollectionService")
+    
+    local props = {
+        Name = targetInstance.Name,
+        ClassName = targetInstance.ClassName,
+        Parent = targetInstance.Parent and targetInstance.Parent.Name or "nil",
+    }
+    
+    -- Ambil Properties Umum secara aman via pcall
+    local function tryProp(propName)
+        local success, val = pcall(function() return targetInstance[propName] end)
+        if success and val ~= nil then
+            if typeof(val) == "Vector3" then
+                props[propName] = {math.round(val.X*100)/100, math.round(val.Y*100)/100, math.round(val.Z*100)/100}
+            elseif typeof(val) == "Color3" then
+                props[propName] = {math.round(val.R * 255), math.round(val.G * 255), math.round(val.B * 255)}
+            elseif typeof(val) == "CFrame" then
+                props[propName] = tostring(val)
+            elseif typeof(val) == "EnumItem" then
+                props[propName] = val.Name
+            elseif typeof(val) == "UDim2" then
+                props[propName] = {val.X.Scale, val.X.Offset, val.Y.Scale, val.Y.Offset}
+            elseif typeof(val) == "Instance" then
+                props[propName] = val:GetFullName()
+            else
+                props[propName] = val
+            end
+        end
+    end
+    
+    local commonProps = {
+        "Anchored", "CanCollide", "Transparency", "Reflectance", 
+        "Position", "Size", "Color", "Material", "Text", "TextColor3", 
+        "BackgroundTransparency", "BackgroundColor3", "Visible", "Enabled",
+        "Volume", "Playing", "Looped", "Value"
+    }
+    
+    for _, prop in ipairs(commonProps) do
+        tryProp(prop)
+    end
+    
+    -- Attributes & Tags
+    pcall(function()
+        props.Attributes = targetInstance:GetAttributes()
+    end)
+    pcall(function()
+        props.Tags = CollectionService:GetTags(targetInstance)
+    end)
+    
+    return { status = "success", result = props }
+end

package/studio-plugin/get_script_source.lua

@@ -0,0 +1,7 @@
+return function(targetInstance, data, ctx, targetPath)
+    if targetInstance:IsA("LuaSourceContainer") then
+        return { status = "success", result = targetInstance.Source }
+    else
+        return { status = "error", error = "Target BUKAN Script (ClassName: " .. targetInstance.ClassName .. "). Kamu WAJIB menggunakan get_children terlebih dahulu sebelum menarik source." }
+    end
+end

package/studio-plugin/insert_asset.lua

@@ -0,0 +1,18 @@
+return function(targetInstance, data, ctx, targetPath)
+    local InsertService = game:GetService("InsertService")
+    local assetId = tonumber(data)
+    if not assetId then
+        return { status = "error", error = "Asset ID harus berupa angka yang valid." }
+    end
+    
+    local success, model = pcall(function()
+        return InsertService:LoadAsset(assetId)
+    end)
+    
+    if success and model then
+        model.Parent = game.Workspace
+        return { status = "success", result = "Aset berhasil dimasukkan ke Workspace." }
+    else
+        return { status = "error", error = "Gagal memuat aset. Pastikan Asset ID benar dan akun/plugin Anda memiliki izin (Ownership/Public)." }
+    end
+end