@adiholick/nvstudio-mcp 2.2.3 → 2.4.0

package/dist/index.js

@@ -12,6 +12,8 @@ const task_queue_1 = require("./task-queue");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const luau_validator_1 = require("./luau-validator");
+const roblox_docs_1 = require("./roblox-docs");
+const vfx_database_1 = require("./vfx-database");
 const HISTORY_DIR = path_1.default.join(__dirname, '..', '.history');
 if (!fs_1.default.existsSync(HISTORY_DIR)) {
     fs_1.default.mkdirSync(HISTORY_DIR, { recursive: true });
@@ -377,9 +379,64 @@ const TOOLS = [
             required: ["material", "position", "size"],
         },
     },
+    {
+        name: "preview_asset",
+        description: "Pratinjau hierarki dan pemindaian keamanan aset Creator Store secara terisolasi sebelum dimasukkan ke dalam game. Mendeteksi skrip backdoor, require eksternal numerik, obfuscation, webhook discord, dan virus script tanpa risiko mengeksekusi kode berbahaya.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                asset_id: {
+                    type: "string",
+                    description: "Roblox Asset ID angka (atau rbxassetid://) dari Creator Store.",
+                },
+                deep_scan: {
+                    type: "boolean",
+                    description: "Jika true (default), memindai dan menganalisis source code seluruh skrip di dalam model.",
+                },
+                placeId: {
+                    type: "number",
+                    description: "Target Place ID untuk multi-Studio routing.",
+                },
+                studioId: {
+                    type: "string",
+                    description: "Target Studio session ID.",
+                },
+            },
+            required: ["asset_id"],
+        },
+    },
+    {
+        name: "scan_security",
+        description: "Audit keamanan instance atau model yang sudah ada di dalam game (Workspace, ServerScriptService, dll.) untuk mendeteksi skrip backdoor, virus, webhook discord, dan kode berbahaya.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                target: {
+                    type: "string",
+                    description: "Path instance atau folder yang ingin diaudit (default: 'Workspace').",
+                },
+                deep_scan: {
+                    type: "boolean",
+                    description: "Jika true (default), memindai isi source code skrip.",
+                },
+                clean_threats: {
+                    type: "boolean",
+                    description: "Jika true, secara otomatis menghapus skrip berbahaya yang terdeteksi (default: false).",
+                },
+                placeId: {
+                    type: "number",
+                    description: "Target Place ID untuk multi-Studio routing.",
+                },
+                studioId: {
+                    type: "string",
+                    description: "Target Studio session ID.",
+                },
+            },
+        },
+    },
     {
         name: "insert_asset",
-        description: "Muat dan masukkan aset Roblox (Model/Package) berdasarkan Asset ID ke dalam Workspace atau target tertentu.",
+        description: "Muat dan masukkan aset Roblox (Model/Package) berdasarkan Asset ID ke dalam Workspace atau target tertentu dengan proteksi sanitasi skrip otomatis.",
         inputSchema: {
             type: "object",
             properties: {
@@ -391,6 +448,14 @@ const TOOLS = [
                     type: "string",
                     description: "Parent tujuan tempat menempatkan model (default: 'Workspace').",
                 },
+                strip_scripts: {
+                    type: "boolean",
+                    description: "Jika true (default: true), secara otomatis menghapus semua skrip dari model sebelum dimasukkan ke game demi keamanan mutlak dari backdoor.",
+                },
+                scan_security: {
+                    type: "boolean",
+                    description: "Jika true (default: true), memindai potensi ancaman keamanan sebelum insert.",
+                },
                 placeId: {
                     type: "number",
                     description: "Target Place ID untuk multi-Studio routing.",
@@ -475,7 +540,7 @@ const TOOLS = [
     },
     {
         name: "call_mcp_tool",
-        description: "Legacy tool dispatcher untuk kompatibilitas mundur. Mendukung semua command: execute_luau, get_children, get_full_tree, get_script_source, update_script_source, patch_script_source, rollback_script, get_properties, set_properties, create_instance, delete_instance, search_instance, generate_terrain, insert_asset, search_asset, script_grep, get_logs.",
+        description: "Legacy tool dispatcher untuk kompatibilitas mundur. Mendukung semua command: execute_luau, get_children, get_full_tree, get_script_source, update_script_source, patch_script_source, rollback_script, get_properties, set_properties, create_instance, delete_instance, search_instance, generate_terrain, insert_asset, preview_asset, scan_security, batch_create_instances, batch_set_properties, search_asset, script_grep, get_roblox_docs, get_logs.",
         inputSchema: {
             type: "object",
             properties: {
@@ -503,6 +568,446 @@ const TOOLS = [
             required: ["command"],
         },
     },
+    {
+        name: "get_roblox_docs",
+        description: "Ambil dokumentasi resmi Roblox Engine API langsung dari Creator Docs (Classes, Services, Data types, Enums, dan Libraries). Mengembalikan format Markdown lengkap beserta signature fungsi, deskripsi parameter, properti, event, dan contoh kode untuk mencegah halusinasi kode Luau.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Nama Class, Service, Data type, Enum, atau Library Roblox (contoh: 'TweenService', 'CanvasGroup', 'Vector3', 'EasingStyle', 'task').",
+                },
+                member: {
+                    type: "string",
+                    description: "Opsional: Nama method, property, event, atau enum item spesifik untuk menghemat token (contoh: 'Create', 'GroupTransparency', 'Completed').",
+                },
+                category: {
+                    type: "string",
+                    enum: ["class", "datatype", "enum", "library", "auto"],
+                    description: "Opsional: Kategori dokumentasi (default: 'auto').",
+                },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "batch_create_instances",
+        description: "Pembangun instance massal dan deklaratif dalam satu kali pemanggilan. Mendukung mode hierarki bersarang (tree) atau daftar array datar (instances) lengkap dengan penyetelan properti langsung (UDim, Vector2, UDim2, Color3, Enum, dll.) untuk menghemat token dan latensi jaringan.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                target: {
+                    type: "string",
+                    description: "Path root tujuan tempat menaruh instance (contoh: 'StarterGui.MyScreen', 'Workspace.Map').",
+                },
+                tree: {
+                    type: "object",
+                    description: "Objek hierarki bersarang { className, name, properties, children: [...] } untuk membangun struktur pohon secara rekursif.",
+                },
+                instances: {
+                    type: "array",
+                    description: "Daftar array datar [{ className, name, parent, properties }] jika tidak menggunakan mode tree.",
+                },
+                placeId: {
+                    type: "number",
+                    description: "Target Place ID untuk multi-Studio routing.",
+                },
+                studioId: {
+                    type: "string",
+                    description: "Target Studio session ID.",
+                },
+            },
+        },
+    },
+    {
+        name: "batch_set_properties",
+        description: "Ubah properti pada banyak instance sekaligus dalam satu kali request atomik.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                updates: {
+                    type: "array",
+                    description: "Array objek pembaruan: [{ target: 'Path.To.Instance', properties: { PropName: value, ... } }].",
+                },
+                placeId: {
+                    type: "number",
+                    description: "Target Place ID untuk multi-Studio routing.",
+                },
+                studioId: {
+                    type: "string",
+                    description: "Target Studio session ID.",
+                },
+            },
+            required: ["updates"],
+        },
+    },
+    {
+        name: "scan_vfx",
+        description: "Pindai efek visual (ParticleEmitter, Beam, Trail, Light) pada objek di Roblox Studio dan simpan ke database persisten MCP untuk digunakan lintas-proyek.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                target: {
+                    type: "string",
+                    description: "Path objek target di Roblox Studio (contoh: 'Workspace.MagicSpell', 'ReplicatedStorage.SlashFX').",
+                },
+                name: {
+                    type: "string",
+                    description: "Nama untuk efek visual ini di database MCP (opsional, default: nama objek).",
+                },
+                category: {
+                    type: "string",
+                    description: "Kategori efek visual (contoh: 'Slash', 'Explosion', 'Aura', 'Projectile', 'Magic', 'Impact', 'Beam', 'Ambient').",
+                    enum: ["Slash", "Explosion", "Aura", "Projectile", "Magic", "Impact", "Beam", "Ambient"],
+                },
+                tags: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Daftar kata kunci pencarian (contoh: ['sword', 'cyan', 'fast']).",
+                },
+                description: {
+                    type: "string",
+                    description: "Catatan penjelasan tentang efek visual ini.",
+                },
+                placeId: {
+                    type: "number",
+                    description: "Target Place ID untuk multi-Studio routing.",
+                },
+                studioId: {
+                    type: "string",
+                    description: "Target Studio session ID.",
+                },
+            },
+            required: ["target"],
+        },
+    },
+    {
+        name: "apply_vfx",
+        description: "Terapkan efek visual yang tersimpan di database persisten MCP ke objek target di Roblox Studio aktif dengan fidelitas 100%.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                vfx_id: {
+                    type: "string",
+                    description: "ID efek visual dari database MCP (contoh: 'preset-cyan-slash', atau ID hasil scan).",
+                },
+                target: {
+                    type: "string",
+                    description: "Path objek tujuan di Studio tempat VFX akan dipasang (contoh: 'Workspace.Player.RightHand', 'Workspace.Map').",
+                },
+                scale: {
+                    type: "number",
+                    description: "Faktor skala ukuran efek visual (contoh: 1.0 = normal, 1.5 = 50% lebih besar, 0.5 = separuh). Default: 1.0.",
+                },
+                enabled: {
+                    type: "boolean",
+                    description: "Paksa status Enabled pada seluruh emitter/beam (opsional).",
+                },
+                placeId: {
+                    type: "number",
+                    description: "Target Place ID untuk multi-Studio routing.",
+                },
+                studioId: {
+                    type: "string",
+                    description: "Target Studio session ID.",
+                },
+            },
+            required: ["vfx_id", "target"],
+        },
+    },
+    {
+        name: "list_vfx_database",
+        description: "Lihat katalog efek visual yang tersimpan di database persisten MCP, lengkap dengan rincian node emitter/beam dan filter kategori.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                category: {
+                    type: "string",
+                    description: "Filter berdasarkan kategori (contoh: 'Slash', 'Aura', 'Explosion', 'Magic', 'Beam', 'Impact').",
+                },
+                query: {
+                    type: "string",
+                    description: "Filter pencarian kata kunci berdasarkan nama, tag, atau deskripsi.",
+                },
+            },
+        },
+    },
+    {
+        name: "delete_vfx",
+        description: "Hapus efek visual dari database persisten MCP berdasarkan ID.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "ID efek visual yang akan dihapus dari database MCP.",
+                },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "animate_character",
+        description: "Buat animasi karakter yang halus (Walk, Slash, Punch, Idle, atau Custom) menggunakan NV-Animation Engine (Analytical LimbIK, Bezier Curves, Easing, dan Floor Pinning), lalu simpan sebagai KeyframeSequence resmi.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                target: {
+                    type: "string",
+                    description: "Path model karakter rig R6 atau R15 di Studio (contoh: 'Workspace.Dummy', 'Workspace.Zombie').",
+                },
+                action: {
+                    type: "string",
+                    description: "Jenis animasi yang ingin dibuat.",
+                    enum: ["walk_cycle", "melee_slash", "punch", "idle_breath", "custom"],
+                },
+                parameters: {
+                    type: "object",
+                    description: "Parameter kustomisasi animasi: { duration: number, intensity: number, easing: string, loop: boolean, clipName: string }.",
+                },
+                key_poses: {
+                    type: "array",
+                    description: "Array pose kunci jika menggunakan action 'custom': [{ time: 0, poses: { MotorName: { angles: [X,Y,Z] } } }].",
+                },
+                placeId: {
+                    type: "number",
+                    description: "Target Place ID untuk multi-Studio routing.",
+                },
+                studioId: {
+                    type: "string",
+                    description: "Target Studio session ID.",
+                },
+            },
+            required: ["target", "action"],
+        },
+    },
+    {
+        name: "solve_limb_ik",
+        description: "Hitung dan terapkan rotasi sendi lengan/kaki (analytical 2-link LimbIK O(1)) menuju koordinat sasaran 3D secara instan dan halus.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                target: {
+                    type: "string",
+                    description: "Path model karakter rig R6 atau R15 di Studio (contoh: 'Workspace.Dummy').",
+                },
+                limb: {
+                    type: "string",
+                    description: "Anggota tubuh yang ingin digerakkan.",
+                    enum: ["LeftArm", "RightArm", "LeftLeg", "RightLeg"],
+                },
+                goal: {
+                    type: "array",
+                    items: { type: "number" },
+                    description: "Target posisi 3D di world space: [X, Y, Z].",
+                },
+                pole: {
+                    type: "array",
+                    items: { type: "number" },
+                    description: "Arah tekukan siku/lutut (pole vector 3D): [X, Y, Z] (opsional).",
+                },
+                apply_to_rig: {
+                    type: "boolean",
+                    description: "Apakah orientasi sendi langsung diterapkan ke model karakter di Studio (default: true).",
+                },
+                placeId: {
+                    type: "number",
+                    description: "Target Place ID untuk multi-Studio routing.",
+                },
+                studioId: {
+                    type: "string",
+                    description: "Target Studio session ID.",
+                },
+            },
+            required: ["target", "limb", "goal"],
+        },
+    },
+    {
+        name: "scrub_timeline",
+        description: "Lakukan scrubbing playhead timeline animasi dan efek visual ke timestamp tertentu (t) secara langsung di Roblox Studio untuk melihat pose karakter dan memicu burst partikel VFX.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                target: {
+                    type: "string",
+                    description: "Path objek target di Studio (Model karakter atau folder VFX).",
+                },
+                time: {
+                    type: "number",
+                    description: "Posisi waktu playhead timeline dalam detik (contoh: 0.35).",
+                },
+                action: {
+                    type: "string",
+                    description: "Aksi animasi yang ingin di-scrub (contoh: 'melee_slash', 'walk_cycle', 'punch', 'idle_breath').",
+                },
+                emit_vfx: {
+                    type: "boolean",
+                    description: "Apakah memicu semburan (burst) partikel pada frame waktu ini (default: true).",
+                },
+                emit_count: {
+                    type: "number",
+                    description: "Jumlah partikel yang disemburkan (default: 20).",
+                },
+                enabled: {
+                    type: "boolean",
+                    description: "Paksa status Enabled pada Beam/Trail pada playhead waktu ini.",
+                },
+                placeId: {
+                    type: "number",
+                    description: "Target Place ID untuk multi-Studio routing.",
+                },
+                studioId: {
+                    type: "string",
+                    description: "Target Studio session ID.",
+                },
+            },
+            required: ["target", "time"],
+        },
+    },
+    {
+        name: "inspect_rig",
+        description: "Inspeksi topologi dan hierarki rig karakter/objek di Studio secara headless. Menganalisis pohon sendi (Motor6D & Weld), mendeteksi circular dependency, memeriksa status anchor, dan melaporkan posisi poros di dunia 3D.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                target: {
+                    type: "string",
+                    description: "Path objek Model karakter atau objek di Studio (contoh: 'Workspace.Dummy').",
+                },
+                placeId: { type: "number", description: "Target Place ID untuk multi-Studio routing." },
+                studioId: { type: "string", description: "Target Studio session ID." },
+            },
+            required: ["target"],
+        },
+    },
+    {
+        name: "edit_rig_joint",
+        description: "Operasi headless sendi NV-Rig Engine: buat Motor6D/Weld baru, geser titik tumpu (pivot) tanpa mendislokasi part anak, putar orientasi poros, setel ulang (reset), selaraskan (align), atau hapus sendi.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                target: {
+                    type: "string",
+                    description: "Path Model karakter/objek di Studio (contoh: 'Workspace.Dummy').",
+                },
+                action: {
+                    type: "string",
+                    description: "Aksi manipulasi sendi.",
+                    enum: ["create_joint", "create_weld", "edit_pivot", "rotate_pivot", "reset_pivot", "align_joint", "remove_joint"],
+                },
+                joint_name: {
+                    type: "string",
+                    description: "Nama sendi yang ingin diedit/dihapus (contoh: 'RightShoulder', 'Neck').",
+                },
+                part0: {
+                    type: "string",
+                    description: "Nama part induk (Part0) untuk create_joint/create_weld (contoh: 'Torso', 'UpperTorso').",
+                },
+                part1: {
+                    type: "string",
+                    description: "Nama part anak (Part1) untuk create_joint/create_weld (contoh: 'Right Arm', 'RightUpperArm').",
+                },
+                delta_world: {
+                    type: "array",
+                    items: { type: "number" },
+                    description: "Pergeseran poros di koordinat dunia [X, Y, Z] untuk edit_pivot.",
+                },
+                target_world: {
+                    type: "array",
+                    items: { type: "number" },
+                    description: "Posisi absolut poros target di dunia [X, Y, Z] untuk edit_pivot.",
+                },
+                rotate_euler_deg: {
+                    type: "array",
+                    items: { type: "number" },
+                    description: "Rotasi poros [Pitch, Yaw, Roll] dalam derajat untuk rotate_pivot.",
+                },
+                align_to: {
+                    type: "string",
+                    description: "Penyelarasan orientasi poros ke 'Part0' atau 'Part1' untuk align_joint.",
+                    enum: ["Part0", "Part1"],
+                },
+                reanchor: {
+                    type: "boolean",
+                    description: "Setel Part1 kembali ke 'Anchored = true' saat menghapus sendi (opsional).",
+                },
+                placeId: { type: "number", description: "Target Place ID untuk multi-Studio routing." },
+                studioId: { type: "string", description: "Target Studio session ID." },
+            },
+            required: ["target", "action"],
+        },
+    },
+    {
+        name: "auto_rig",
+        description: "Auto-rigging cerdas 1-klik untuk Avatar R6, R15, atau Penautan Senjata (Weapon/Tool) dengan matematika kompensasi spasial otomatis.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                target: {
+                    type: "string",
+                    description: "Path Model karakter di Studio (contoh: 'Workspace.Dummy', 'Workspace.CustomAvatar').",
+                },
+                rig_type: {
+                    type: "string",
+                    description: "Tipe rig yang ingin dibangun secara otomatis.",
+                    enum: ["R6", "R15", "Weapon"],
+                },
+                weapon_target: {
+                    type: "string",
+                    description: "Path objek senjata/prop di Studio jika rig_type='Weapon' (contoh: 'Workspace.Sword').",
+                },
+                target_limb: {
+                    type: "string",
+                    description: "Anggota tubuh tempat senjata dipasang (contoh: 'RightHand' atau 'Right Arm').",
+                },
+                placeId: { type: "number", description: "Target Place ID untuk multi-Studio routing." },
+                studioId: { type: "string", description: "Target Studio session ID." },
+            },
+            required: ["target", "rig_type"],
+        },
+    },
+    {
+        name: "weld_assembly",
+        description: "Las (Weld) seluruh komponen BasePart pada sebuah model (aksesori, armor, prop, kendaraan) ke PrimaryPart secara otomatis dengan unanchor aman.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                target: {
+                    type: "string",
+                    description: "Path Model atau Folder di Studio yang ingin dilas (contoh: 'Workspace.ArmorSet').",
+                },
+                primary_part: {
+                    type: "string",
+                    description: "Nama part utama sebagai jangkar (opsional, jika kosong menggunakan PrimaryPart atau part terbesar).",
+                },
+                placeId: { type: "number", description: "Target Place ID untuk multi-Studio routing." },
+                studioId: { type: "string", description: "Target Studio session ID." },
+            },
+            required: ["target"],
+        },
+    },
+    {
+        name: "mirror_rig",
+        description: "Cerminkan sambungan sendi bilateral (Left <-> Right) sepanjang sumbu simetri X secara matematis, menghemat waktu konfigurasi karakter.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                target: {
+                    type: "string",
+                    description: "Path Model karakter di Studio (contoh: 'Workspace.Dummy').",
+                },
+                source_side: {
+                    type: "string",
+                    description: "Sisi sumber yang ingin dicerminkan.",
+                    enum: ["Left", "Right"],
+                },
+                placeId: { type: "number", description: "Target Place ID untuk multi-Studio routing." },
+                studioId: { type: "string", description: "Target Studio session ID." },
+            },
+            required: ["target"],
+        },
+    },
 ];
 server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
     return { tools: TOOLS };
@@ -752,11 +1257,41 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                 });
                 break;
             }
+            case "preview_asset": {
+                const assetId = String(args.asset_id ?? "");
+                if (!assetId)
+                    throw new Error("Parameter 'asset_id' wajib diisi.");
+                const payload = JSON.stringify({
+                    asset_id: assetId,
+                    deep_scan: args.deep_scan !== false,
+                });
+                result = await dispatchTaskToStudio("preview_asset", "", payload, {
+                    placeId: args.placeId,
+                    studioId: args.studioId,
+                });
+                break;
+            }
+            case "scan_security": {
+                const payload = JSON.stringify({
+                    deep_scan: args.deep_scan !== false,
+                    clean_threats: args.clean_threats === true,
+                });
+                result = await dispatchTaskToStudio("scan_security", args.target || "Workspace", payload, {
+                    placeId: args.placeId,
+                    studioId: args.studioId,
+                });
+                break;
+            }
             case "insert_asset": {
                 const assetId = String(args.asset_id ?? "");
                 if (!assetId)
                     throw new Error("Parameter 'asset_id' wajib diisi.");
-                result = await dispatchTaskToStudio("insert_asset", args.target || "Workspace", assetId, {
+                const payload = JSON.stringify({
+                    asset_id: assetId,
+                    strip_scripts: args.strip_scripts !== false,
+                    scan_security: args.scan_security !== false,
+                });
+                result = await dispatchTaskToStudio("insert_asset", args.target || "Workspace", payload, {
                     placeId: args.placeId,
                     studioId: args.studioId,
                 });
@@ -802,6 +1337,269 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                 }
                 break;
             }
+            case "get_roblox_docs": {
+                const query = String(args.query ?? "").trim();
+                if (!query)
+                    throw new Error("Parameter 'query' wajib diisi.");
+                const member = args.member ? String(args.member).trim() : undefined;
+                const category = args.category ? String(args.category).trim() : "auto";
+                result = await (0, roblox_docs_1.getRobloxDocs)(query, member, category);
+                break;
+            }
+            case "batch_create_instances": {
+                const payload = JSON.stringify({
+                    target: args.target,
+                    tree: args.tree,
+                    instances: args.instances,
+                });
+                result = await dispatchTaskToStudio("batch_create_instances", args.target || "Workspace", payload, {
+                    placeId: args.placeId,
+                    studioId: args.studioId,
+                });
+                break;
+            }
+            case "batch_set_properties": {
+                if (!args.updates || !Array.isArray(args.updates))
+                    throw new Error("Parameter 'updates' wajib berupa array.");
+                const payload = JSON.stringify({
+                    updates: args.updates,
+                });
+                result = await dispatchTaskToStudio("batch_set_properties", "", payload, {
+                    placeId: args.placeId,
+                    studioId: args.studioId,
+                });
+                break;
+            }
+            case "scan_vfx": {
+                const target = String(args.target ?? "");
+                if (!target)
+                    throw new Error("Parameter 'target' wajib diisi.");
+                const payload = JSON.stringify({
+                    name: args.name,
+                    category: args.category,
+                    tags: args.tags,
+                    description: args.description,
+                });
+                const scanRes = await dispatchTaskToStudio("scan_vfx", target, payload, {
+                    placeId: args.placeId,
+                    studioId: args.studioId,
+                });
+                if (scanRes && (scanRes.status === "success" || !scanRes.error)) {
+                    const scanned = scanRes.result || scanRes;
+                    const db = (0, vfx_database_1.getVfxDatabase)();
+                    const saved = db.saveVfx({
+                        name: scanned.name || args.name || "Scanned_VFX",
+                        category: scanned.category || args.category || "Ambient",
+                        tags: scanned.tags || args.tags || [],
+                        description: scanned.description || args.description,
+                        sourcePlaceId: args.placeId,
+                        stats: scanned.stats,
+                        nodeCount: scanned.nodeCount,
+                        data: scanned.data,
+                    });
+                    result = {
+                        status: "success",
+                        message: `VFX '${saved.name}' berhasil dipindai dan disimpan ke database persisten MCP dengan ID '${saved.id}'`,
+                        item: saved,
+                    };
+                }
+                else {
+                    throw new Error(scanRes?.error || "Gagal memindai VFX dari Studio.");
+                }
+                break;
+            }
+            case "apply_vfx": {
+                const vfxId = String(args.vfx_id ?? "");
+                const target = String(args.target ?? "");
+                if (!vfxId)
+                    throw new Error("Parameter 'vfx_id' wajib diisi.");
+                if (!target)
+                    throw new Error("Parameter 'target' wajib diisi.");
+                const db = (0, vfx_database_1.getVfxDatabase)();
+                const item = db.getVfx(vfxId);
+                if (!item)
+                    throw new Error(`VFX dengan ID '${vfxId}' tidak ditemukan di database MCP.`);
+                const payload = JSON.stringify({
+                    data: item.data,
+                    scale: args.scale,
+                    enabled: args.enabled,
+                });
+                result = await dispatchTaskToStudio("apply_vfx", target, payload, {
+                    placeId: args.placeId,
+                    studioId: args.studioId,
+                });
+                break;
+            }
+            case "list_vfx_database": {
+                const db = (0, vfx_database_1.getVfxDatabase)();
+                const items = db.listVfx({ category: args.category, query: args.query });
+                const categories = db.getCategories();
+                result = {
+                    total: items.length,
+                    categories,
+                    items: items.map(i => ({
+                        id: i.id,
+                        name: i.name,
+                        category: i.category,
+                        tags: i.tags,
+                        description: i.description,
+                        nodeCount: i.nodeCount,
+                        stats: i.stats,
+                        createdAt: i.createdAt,
+                    })),
+                };
+                break;
+            }
+            case "delete_vfx": {
+                const id = String(args.id ?? "");
+                if (!id)
+                    throw new Error("Parameter 'id' wajib diisi.");
+                const db = (0, vfx_database_1.getVfxDatabase)();
+                const deleted = db.deleteVfx(id);
+                if (!deleted)
+                    throw new Error(`VFX dengan ID '${id}' tidak ditemukan di database MCP.`);
+                result = { status: "success", message: `VFX '${id}' berhasil dihapus dari database.` };
+                break;
+            }
+            case "animate_character": {
+                const target = String(args.target ?? "");
+                const action = String(args.action ?? "");
+                if (!target)
+                    throw new Error("Parameter 'target' wajib diisi.");
+                if (!action)
+                    throw new Error("Parameter 'action' wajib diisi.");
+                const payload = JSON.stringify({
+                    action,
+                    parameters: args.parameters || {},
+                    key_poses: args.key_poses,
+                });
+                result = await dispatchTaskToStudio("animate_character", target, payload, {
+                    placeId: args.placeId,
+                    studioId: args.studioId,
+                });
+                break;
+            }
+            case "solve_limb_ik": {
+                const target = String(args.target ?? "");
+                const limb = String(args.limb ?? "");
+                if (!target)
+                    throw new Error("Parameter 'target' wajib diisi.");
+                if (!limb)
+                    throw new Error("Parameter 'limb' wajib diisi.");
+                if (!args.goal || !Array.isArray(args.goal) || args.goal.length < 3) {
+                    throw new Error("Parameter 'goal' [X, Y, Z] wajib diisi.");
+                }
+                const payload = JSON.stringify({
+                    limb,
+                    goal: args.goal,
+                    pole: args.pole,
+                    apply_to_rig: args.apply_to_rig !== false,
+                });
+                result = await dispatchTaskToStudio("solve_limb_ik", target, payload, {
+                    placeId: args.placeId,
+                    studioId: args.studioId,
+                });
+                break;
+            }
+            case "scrub_timeline": {
+                const target = String(args.target ?? "");
+                if (!target)
+                    throw new Error("Parameter 'target' wajib diisi.");
+                const payload = JSON.stringify({
+                    time: args.time,
+                    action: args.action,
+                    emit_vfx: args.emit_vfx !== false,
+                    emit_count: args.emit_count,
+                    enabled: args.enabled,
+                });
+                result = await dispatchTaskToStudio("scrub_timeline", target, payload, {
+                    placeId: args.placeId,
+                    studioId: args.studioId,
+                });
+                break;
+            }
+            case "inspect_rig": {
+                const target = String(args.target ?? "");
+                if (!target)
+                    throw new Error("Parameter 'target' wajib diisi.");
+                const payload = JSON.stringify({ action: "inspect" });
+                result = await dispatchTaskToStudio("edit_rig", target, payload, {
+                    placeId: args.placeId,
+                    studioId: args.studioId,
+                });
+                break;
+            }
+            case "edit_rig_joint": {
+                const target = String(args.target ?? "");
+                const action = String(args.action ?? "edit_pivot");
+                if (!target)
+                    throw new Error("Parameter 'target' wajib diisi.");
+                const payload = JSON.stringify({
+                    action,
+                    joint_name: args.joint_name,
+                    part0: args.part0,
+                    part1: args.part1,
+                    delta_world: args.delta_world,
+                    target_world: args.target_world,
+                    rotate_euler_deg: args.rotate_euler_deg,
+                    align_to: args.align_to,
+                    reanchor: args.reanchor,
+                });
+                result = await dispatchTaskToStudio("edit_rig", target, payload, {
+                    placeId: args.placeId,
+                    studioId: args.studioId,
+                });
+                break;
+            }
+            case "auto_rig": {
+                const target = String(args.target ?? "");
+                const rigType = String(args.rig_type ?? "R15");
+                if (!target)
+                    throw new Error("Parameter 'target' wajib diisi.");
+                let action = "auto_rig_r15";
+                if (rigType === "R6")
+                    action = "auto_rig_r6";
+                else if (rigType === "Weapon")
+                    action = "rig_weapon";
+                const payload = JSON.stringify({
+                    action,
+                    weapon_target: args.weapon_target,
+                    target_limb: args.target_limb,
+                });
+                result = await dispatchTaskToStudio("edit_rig", target, payload, {
+                    placeId: args.placeId,
+                    studioId: args.studioId,
+                });
+                break;
+            }
+            case "weld_assembly": {
+                const target = String(args.target ?? "");
+                if (!target)
+                    throw new Error("Parameter 'target' wajib diisi.");
+                const payload = JSON.stringify({
+                    action: "weld_assembly",
+                    primary_part: args.primary_part,
+                });
+                result = await dispatchTaskToStudio("edit_rig", target, payload, {
+                    placeId: args.placeId,
+                    studioId: args.studioId,
+                });
+                break;
+            }
+            case "mirror_rig": {
+                const target = String(args.target ?? "");
+                if (!target)
+                    throw new Error("Parameter 'target' wajib diisi.");
+                const payload = JSON.stringify({
+                    action: "mirror",
+                    source_side: args.source_side || "Left",
+                });
+                result = await dispatchTaskToStudio("edit_rig", target, payload, {
+                    placeId: args.placeId,
+                    studioId: args.studioId,
+                });
+                break;
+            }
             case "call_mcp_tool": {
                 const { command, target, data, placeId, studioId } = args;
                 if (!command)
@@ -815,12 +1613,52 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                     if (target)
                         backupScript(target, String(data));
                 }
+                // Intercept get_roblox_docs di Node.js
+                if (command === "get_roblox_docs") {
+                    const queryParams = typeof data === "string" ? (function () { try {
+                        return JSON.parse(data);
+                    }
+                    catch {
+                        return { query: data };
+                    } })() : (data || {});
+                    const q = String(queryParams.query || target || "").trim();
+                    result = await (0, roblox_docs_1.getRobloxDocs)(q, queryParams.member, queryParams.category);
+                    break;
+                }
                 // Intercept search_asset di Node.js
                 if (command === "search_asset" && data) {
                     const queryParams = typeof data === "string" ? JSON.parse(data) : data;
                     result = await handleSearchAsset(queryParams.keyword || "", queryParams.category);
                     break;
                 }
+                // Intercept VFX database tools di Node.js
+                if (command === "list_vfx_database") {
+                    const queryParams = typeof data === "string" ? JSON.parse(data || "{}") : (data || {});
+                    const db = (0, vfx_database_1.getVfxDatabase)();
+                    result = {
+                        total: db.listVfx(queryParams).length,
+                        categories: db.getCategories(),
+                        items: db.listVfx(queryParams),
+                    };
+                    break;
+                }
+                if (command === "delete_vfx") {
+                    const queryParams = typeof data === "string" ? JSON.parse(data || "{}") : (data || {});
+                    const db = (0, vfx_database_1.getVfxDatabase)();
+                    const ok = db.deleteVfx(queryParams.id || target || "");
+                    result = { success: ok };
+                    break;
+                }
+                if (command === "apply_vfx") {
+                    const queryParams = typeof data === "string" ? JSON.parse(data || "{}") : (data || {});
+                    const db = (0, vfx_database_1.getVfxDatabase)();
+                    const item = db.getVfx(queryParams.vfx_id || queryParams.id || "");
+                    if (!item)
+                        throw new Error("VFX tidak ditemukan di database MCP.");
+                    const payload = JSON.stringify({ data: item.data, scale: queryParams.scale, enabled: queryParams.enabled });
+                    result = await dispatchTaskToStudio("apply_vfx", target || queryParams.target || "Workspace", payload, { placeId, studioId });
+                    break;
+                }
                 result = await dispatchTaskToStudio(command, target || "", data, { placeId, studioId });
                 break;
             }