robloxstudio-mcp 2.2.8 → 2.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "robloxstudio-mcp",
-  "version": "2.2.8",
+  "version": "2.4.0",
   "description": "MCP Server for Roblox Studio Integration - Access Studio data, scripts, and objects through AI tools",
   "main": "dist/index.js",
   "type": "module",
@@ -9,23 +9,12 @@
   },
   "files": [
     "dist/**/*",
-    "studio-plugin/**/*",
-    "README.md"
+    "studio-plugin/**/*"
   ],
   "scripts": {
-    "build": "tsc",
-    "build:plugin": "node scripts/build-plugin.mjs",
-    "build:all": "npm run build && npm run build:plugin",
-    "dev": "tsx src/index.ts",
-    "start": "node dist/index.js",
-    "lint": "eslint src/**/*.ts",
-    "typecheck": "tsc --noEmit",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage",
-    "test:e2e": "lune run tests/luau/e2e.luau",
-    "test:all": "npm test && npm run test:e2e",
-    "prepublishOnly": "npm run build:all"
+    "build": "tsup",
+    "prepack": "node ../../scripts/prepack.mjs",
+    "postpack": "node ../../scripts/postpack.mjs"
   },
   "keywords": [
     "mcp",
@@ -54,20 +43,6 @@
     "ws": "^8.14.2"
   },
   "devDependencies": {
-    "@types/cors": "^2.8.17",
-    "@types/express": "^4.17.21",
-    "@types/jest": "^29.5.11",
-    "@types/node": "^20.10.0",
-    "@types/supertest": "^6.0.2",
-    "@types/uuid": "^9.0.7",
-    "@types/ws": "^8.5.10",
-    "@typescript-eslint/eslint-plugin": "^7.0.0",
-    "@typescript-eslint/parser": "^7.0.0",
-    "eslint": "^8.57.0",
-    "jest": "^29.7.0",
-    "supertest": "^6.3.3",
-    "ts-jest": "^29.1.1",
-    "tsx": "^4.6.0",
-    "typescript": "^5.3.2"
+    "@robloxstudio-mcp/core": "*"
   }
 }

package/studio-plugin/MCPPlugin.rbxmx

@@ -440,7 +440,7 @@ local function checkForUpdates()
 				local latestVersion = data.version
 				if Utils.compareVersions(State.CURRENT_VERSION, latestVersion) < 0 then
 					local ui = UI.getElements()
-					ui.updateBannerText.Text = `Update available: v{latestVersion}`
+					ui.updateBannerText.Text = `v{latestVersion} available - github.com/boshyxd/robloxstudio-mcp`
 					ui.updateBanner.Visible = true
 					ui.contentFrame.Position = UDim2.new(0, 8, 0, 92)
 					ui.contentFrame.Size = UDim2.new(1, -16, 1, -100)
@@ -3173,7 +3173,7 @@ return {
         <Properties>
           <string name="Name">State</string>
           <string name="Source"><![CDATA[-- Compiled with roblox-ts v3.0.0
-local CURRENT_VERSION = "2.2.8"
+local CURRENT_VERSION = "2.4.0"
 local MAX_CONNECTIONS = 5
 local BASE_PORT = 58741
 local activeTabIndex = 0
@@ -3606,28 +3606,15 @@ local function init(pluginRef)
 	updateBannerCorner.CornerRadius = UDim.new(0, 3)
 	updateBannerCorner.Parent = updateBanner
 	local updateBannerText = Instance.new("TextLabel")
-	updateBannerText.Size = UDim2.new(1, -54, 1, 0)
+	updateBannerText.Size = UDim2.new(1, -16, 1, 0)
 	updateBannerText.Position = UDim2.new(0, 8, 0, 0)
 	updateBannerText.BackgroundTransparency = 1
-	updateBannerText.Text = "Update available: v0.0.0"
+	updateBannerText.Text = ""
 	updateBannerText.TextColor3 = C.yellow
 	updateBannerText.TextSize = 9
 	updateBannerText.Font = Enum.Font.GothamMedium
 	updateBannerText.TextXAlignment = Enum.TextXAlignment.Left
 	updateBannerText.Parent = updateBanner
-	local updateLink = Instance.new("TextButton")
-	updateLink.Size = UDim2.new(0, 40, 0, 16)
-	updateLink.Position = UDim2.new(1, -46, 0, 4)
-	updateLink.BackgroundColor3 = C.yellow
-	updateLink.BackgroundTransparency = 0.85
-	updateLink.Text = "Get"
-	updateLink.TextColor3 = C.yellow
-	updateLink.TextSize = 9
-	updateLink.Font = Enum.Font.GothamBold
-	updateLink.Parent = updateBanner
-	local updateLinkCorner = Instance.new("UICorner")
-	updateLinkCorner.CornerRadius = UDim.new(0, 3)
-	updateLinkCorner.Parent = updateLink
 	local contentY = 66
 	local contentFrame = Instance.new("ScrollingFrame")
 	contentFrame.Size = UDim2.new(1, -16, 1, -(contentY + 8))
@@ -3810,22 +3797,6 @@ local function init(pluginRef)
 			setButtonConnect(connectButton, connectStroke)
 		end
 	end)
-	updateLink.Activated:Connect(function()
-		local url = "https://github.com/boshyxd/robloxstudio-mcp/releases"
-		local env = getfenv(0)
-		local _value = env.setclipboard
-		if _value ~= 0 and _value == _value and _value ~= "" and _value then
-			pcall(function()
-				env.setclipboard(url)
-			end)
-		end
-		updateBannerText.Text = "Link copied!"
-		task.delay(3, function()
-			if updateBanner.Visible then
-				updateBannerText.Text = "Update available - check GitHub"
-			end
-		end)
-	end)
 	elements = {
 		screenGui = screenGui,
 		mainFrame = mainFrame,

package/studio-plugin/{ts-src → src}/modules/Communication.ts

@@ -8,6 +8,8 @@ import InstanceHandlers from "./handlers/InstanceHandlers";
 import ScriptHandlers from "./handlers/ScriptHandlers";
 import MetadataHandlers from "./handlers/MetadataHandlers";
 import TestHandlers from "./handlers/TestHandlers";
+import BuildHandlers from "./handlers/BuildHandlers";
+import AssetHandlers from "./handlers/AssetHandlers";
 import { Connection, RequestPayload, PollResponse } from "../types";
 
 type Handler = (data: Record<string, unknown>) => unknown;
@@ -24,6 +26,7 @@ const routeMap: Record<string, Handler> = {
 	"/api/search-by-property": QueryHandlers.searchByProperty,
 	"/api/class-info": QueryHandlers.getClassInfo,
 	"/api/project-structure": QueryHandlers.getProjectStructure,
+	"/api/grep-scripts": QueryHandlers.grepScripts,
 
 	"/api/set-property": PropertyHandlers.setProperty,
 	"/api/mass-set-property": PropertyHandlers.massSetProperty,
@@ -54,10 +57,20 @@ const routeMap: Record<string, Handler> = {
 	"/api/get-tagged": MetadataHandlers.getTagged,
 	"/api/get-selection": MetadataHandlers.getSelection,
 	"/api/execute-luau": MetadataHandlers.executeLuau,
+	"/api/undo": MetadataHandlers.undo,
+	"/api/redo": MetadataHandlers.redo,
 
 	"/api/start-playtest": TestHandlers.startPlaytest,
 	"/api/stop-playtest": TestHandlers.stopPlaytest,
 	"/api/get-playtest-output": TestHandlers.getPlaytestOutput,
+
+	"/api/export-build": BuildHandlers.exportBuild,
+	"/api/import-build": BuildHandlers.importBuild,
+	"/api/import-scene": BuildHandlers.importScene,
+	"/api/search-materials": BuildHandlers.searchMaterials,
+
+	"/api/insert-asset": AssetHandlers.insertAsset,
+	"/api/preview-asset": AssetHandlers.previewAsset,
 };
 
 function processRequest(request: RequestPayload): unknown {
@@ -365,7 +378,7 @@ function checkForUpdates() {
 				const latestVersion = data.version;
 				if (Utils.compareVersions(State.CURRENT_VERSION, latestVersion) < 0) {
 					const ui = UI.getElements();
-					ui.updateBannerText.Text = `Update available: v${latestVersion}`;
+					ui.updateBannerText.Text = `v${latestVersion} available - github.com/boshyxd/robloxstudio-mcp`;
 					ui.updateBanner.Visible = true;
 					ui.contentFrame.Position = new UDim2(0, 8, 0, 92);
 					ui.contentFrame.Size = new UDim2(1, -16, 1, -100);

package/studio-plugin/src/modules/Recording.ts

@@ -0,0 +1,28 @@
+const ChangeHistoryService = game.GetService("ChangeHistoryService");
+
+type RecordingId = string | undefined;
+
+function beginRecording(actionName: string): RecordingId {
+	const [success, result] = pcall(() => ChangeHistoryService.TryBeginRecording(`MCP: ${actionName}`));
+	if (success) {
+		return result as RecordingId;
+	}
+	return undefined;
+}
+
+function finishRecording(recordingId: RecordingId, shouldCommit: boolean) {
+	if (recordingId === undefined) return;
+
+	const operation = shouldCommit
+		? Enum.FinishRecordingOperation.Commit
+		: Enum.FinishRecordingOperation.Cancel;
+
+	pcall(() => {
+		ChangeHistoryService.FinishRecording(recordingId, operation);
+	});
+}
+
+export = {
+	beginRecording,
+	finishRecording,
+};

package/studio-plugin/{ts-src → src}/modules/UI.ts

@@ -362,31 +362,16 @@ function init(pluginRef: Plugin) {
 	updateBannerCorner.Parent = updateBanner;
 
 	const updateBannerText = new Instance("TextLabel");
-	updateBannerText.Size = new UDim2(1, -54, 1, 0);
+	updateBannerText.Size = new UDim2(1, -16, 1, 0);
 	updateBannerText.Position = new UDim2(0, 8, 0, 0);
 	updateBannerText.BackgroundTransparency = 1;
-	updateBannerText.Text = "Update available: v0.0.0";
+	updateBannerText.Text = "";
 	updateBannerText.TextColor3 = C.yellow;
 	updateBannerText.TextSize = 9;
 	updateBannerText.Font = Enum.Font.GothamMedium;
 	updateBannerText.TextXAlignment = Enum.TextXAlignment.Left;
 	updateBannerText.Parent = updateBanner;
 
-	const updateLink = new Instance("TextButton");
-	updateLink.Size = new UDim2(0, 40, 0, 16);
-	updateLink.Position = new UDim2(1, -46, 0, 4);
-	updateLink.BackgroundColor3 = C.yellow;
-	updateLink.BackgroundTransparency = 0.85;
-	updateLink.Text = "Get";
-	updateLink.TextColor3 = C.yellow;
-	updateLink.TextSize = 9;
-	updateLink.Font = Enum.Font.GothamBold;
-	updateLink.Parent = updateBanner;
-
-	const updateLinkCorner = new Instance("UICorner");
-	updateLinkCorner.CornerRadius = new UDim(0, 3);
-	updateLinkCorner.Parent = updateLink;
-
 	const contentY = 66;
 	const contentFrame = new Instance("ScrollingFrame");
 	contentFrame.Size = new UDim2(1, -16, 1, -(contentY + 8));
@@ -580,21 +565,6 @@ function init(pluginRef: Plugin) {
 		}
 	});
 
-	updateLink.Activated.Connect(() => {
-		const url = "https://github.com/boshyxd/robloxstudio-mcp/releases";
-		const env = getfenv(0) as unknown as Record<string, unknown>;
-		if (env["setclipboard"]) {
-			pcall(() => {
-				(env["setclipboard"] as (s: string) => void)(url);
-			});
-		}
-		updateBannerText.Text = "Link copied!";
-		task.delay(3, () => {
-			if (updateBanner.Visible) {
-				updateBannerText.Text = "Update available - check GitHub";
-			}
-		});
-	});
 
 	elements = {
 		screenGui, mainFrame, contentFrame, statusLabel, detailStatusLabel,

package/studio-plugin/src/modules/handlers/AssetHandlers.ts

@@ -0,0 +1,230 @@
+import Utils from "../Utils";
+import Recording from "../Recording";
+
+const AssetService = game.GetService("AssetService");
+const ChangeHistoryService = game.GetService("ChangeHistoryService");
+const Selection = game.GetService("Selection");
+
+const { getInstancePath, getInstanceByPath } = Utils;
+const { beginRecording, finishRecording } = Recording;
+
+function insertAsset(requestData: Record<string, unknown>) {
+	const assetId = requestData.assetId as number;
+	const parentPath = (requestData.parentPath as string) ?? "game.Workspace";
+	const position = requestData.position as { x: number; y: number; z: number } | undefined;
+
+	if (!assetId) {
+		return { error: "assetId is required" };
+	}
+
+	const parentInstance = getInstanceByPath(parentPath);
+	if (!parentInstance) {
+		return { error: `Parent instance not found: ${parentPath}` };
+	}
+
+	const recordingId = beginRecording(`Insert asset ${assetId}`);
+
+	const [loadSuccess, wrapperModel] = pcall(() => {
+		return (AssetService as unknown as { LoadAssetAsync(id: number): Instance }).LoadAssetAsync(assetId);
+	});
+
+	if (!loadSuccess || !wrapperModel) {
+		finishRecording(recordingId, false);
+		return { error: `Failed to load asset ${assetId}: ${tostring(wrapperModel)}` };
+	}
+
+	const insertedInstances: Instance[] = [];
+	const children = (wrapperModel as Instance).GetChildren();
+
+	for (const child of children) {
+		child.Parent = parentInstance;
+		insertedInstances.push(child);
+	}
+
+	// Apply position if provided
+	if (position) {
+		const pos = new Vector3(position.x ?? 0, position.y ?? 0, position.z ?? 0);
+		for (const inst of insertedInstances) {
+			if (inst.IsA("BasePart")) {
+				inst.Position = pos;
+			} else if (inst.IsA("Model")) {
+				if (inst.PrimaryPart) {
+					inst.PivotTo(new CFrame(pos));
+				} else {
+					// Find first BasePart descendant to pivot around
+					const firstPart = inst.FindFirstChildWhichIsA("BasePart", true);
+					if (firstPart) {
+						inst.PivotTo(new CFrame(pos));
+					}
+				}
+			}
+		}
+	}
+
+	// Destroy the wrapper model
+	(wrapperModel as Instance).Destroy();
+
+	// Set undo waypoint
+	finishRecording(recordingId, true);
+
+	// Select inserted instances
+	pcall(() => {
+		Selection.Set(insertedInstances);
+	});
+
+	const resultInstances = insertedInstances.map((inst) => ({
+		name: inst.Name,
+		className: inst.ClassName,
+		path: getInstancePath(inst),
+	}));
+
+	return {
+		success: true,
+		assetId,
+		parentPath,
+		insertedCount: insertedInstances.size(),
+		instances: resultInstances,
+	};
+}
+
+function previewAsset(requestData: Record<string, unknown>) {
+	const assetId = requestData.assetId as number;
+	const includeProperties = (requestData.includeProperties as boolean) ?? true;
+	const maxDepth = (requestData.maxDepth as number) ?? 10;
+
+	if (!assetId) {
+		return { error: "assetId is required" };
+	}
+
+	const [loadSuccess, wrapperModel] = pcall(() => {
+		return (AssetService as unknown as { LoadAssetAsync(id: number): Instance }).LoadAssetAsync(assetId);
+	});
+
+	if (!loadSuccess || !wrapperModel) {
+		return { error: `Failed to load asset ${assetId}: ${tostring(wrapperModel)}` };
+	}
+
+	// Stats tracking
+	let totalInstances = 0;
+	const classCounts: Record<string, number> = {};
+	let hasScripts = false;
+	let hasAnimations = false;
+	let hasSounds = false;
+	let hasParticles = false;
+
+	function buildHierarchy(instance: Instance, depth: number): Record<string, unknown> {
+		totalInstances++;
+
+		const className = instance.ClassName;
+		classCounts[className] = (classCounts[className] ?? 0) + 1;
+
+		if (instance.IsA("LuaSourceContainer")) hasScripts = true;
+		if (className === "Animation" || className === "AnimationController" || className === "Animator") hasAnimations = true;
+		if (instance.IsA("Sound")) hasSounds = true;
+		if (className === "ParticleEmitter" || className === "Fire" || className === "Smoke" || className === "Sparkles") hasParticles = true;
+
+		const node: Record<string, unknown> = {
+			name: instance.Name,
+			className,
+		};
+
+		if (includeProperties) {
+			const props: Record<string, unknown> = {};
+
+			if (instance.IsA("BasePart")) {
+				props.size = { x: instance.Size.X, y: instance.Size.Y, z: instance.Size.Z };
+				props.position = { x: instance.Position.X, y: instance.Position.Y, z: instance.Position.Z };
+				props.material = tostring(instance.Material);
+				props.color = `${instance.Color.R}, ${instance.Color.G}, ${instance.Color.B}`;
+				props.transparency = instance.Transparency;
+				props.anchored = instance.Anchored;
+			}
+
+			if (instance.IsA("MeshPart")) {
+				const meshPart = instance as MeshPart;
+				props.meshId = meshPart.MeshId;
+				props.textureId = meshPart.TextureID;
+			}
+
+			if (instance.IsA("Model")) {
+				const model = instance as Model;
+				if (model.PrimaryPart) {
+					props.primaryPart = model.PrimaryPart.Name;
+				}
+			}
+
+			if (instance.IsA("LuaSourceContainer")) {
+				const [ok, src] = pcall(() => (instance as unknown as { Source: string }).Source);
+				if (ok && src) {
+					const preview = string.sub(src, 1, 200);
+					props.sourcePreview = preview;
+					props.sourceLength = src.size();
+				}
+			}
+
+			if (className === "Decal" || className === "Texture") {
+				const [ok, texId] = pcall(() => (instance as unknown as { Texture: string }).Texture);
+				if (ok) props.texture = texId;
+			}
+
+			if (instance.IsA("Sound")) {
+				props.soundId = (instance as Sound).SoundId;
+			}
+
+			// Only include props if there are any
+			let hasProps = false;
+			for (const _ of pairs(props)) {
+				hasProps = true;
+				break;
+			}
+			if (hasProps) {
+				node.properties = props;
+			}
+		}
+
+		if (depth < maxDepth) {
+			const childNodes: Record<string, unknown>[] = [];
+			for (const child of instance.GetChildren()) {
+				childNodes.push(buildHierarchy(child, depth + 1));
+			}
+			if (childNodes.size() > 0) {
+				node.children = childNodes;
+			}
+		} else {
+			const childCount = instance.GetChildren().size();
+			if (childCount > 0) {
+				node.childCount = childCount;
+				node.truncated = true;
+			}
+		}
+
+		return node;
+	}
+
+	const hierarchyRoots: Record<string, unknown>[] = [];
+	for (const child of (wrapperModel as Instance).GetChildren()) {
+		hierarchyRoots.push(buildHierarchy(child, 0));
+	}
+
+	// CRITICAL: Destroy wrapper to prevent memory leak
+	(wrapperModel as Instance).Destroy();
+
+	return {
+		success: true,
+		assetId,
+		hierarchy: hierarchyRoots,
+		summary: {
+			totalInstances,
+			classCounts,
+			hasScripts,
+			hasAnimations,
+			hasSounds,
+			hasParticles,
+		},
+	};
+}
+
+export = {
+	insertAsset,
+	previewAsset,
+};