robloxstudio-mcp 2.6.0 → 2.7.0-next.0

package/dist/index.js

@@ -1046,14 +1046,29 @@ var OpenCloudClient = class {
   getMimeType(fileName) {
     const ext = fileName.split(".").pop()?.toLowerCase();
     const mimeTypes = {
+      // Image (Decal)
       png: "image/png",
       jpg: "image/jpeg",
       jpeg: "image/jpeg",
       bmp: "image/bmp",
-      tga: "image/x-tga"
+      tga: "image/tga",
+      // Audio
+      mp3: "audio/mpeg",
+      ogg: "audio/ogg",
+      wav: "audio/wav",
+      flac: "audio/flac",
+      // Model
+      fbx: "model/fbx",
+      gltf: "model/gltf+json",
+      glb: "model/gltf-binary",
+      rbxm: "model/x-rbxm",
+      rbxmx: "model/x-rbxm",
+      // Video
+      mp4: "video/mp4",
+      mov: "video/mov"
     };
     if (!ext || !mimeTypes[ext]) {
-      throw new Error(`Unsupported image format: ${fileName}. Supported: PNG, JPG, BMP, TGA`);
+      throw new Error(`Unsupported file format: .${ext ?? "(none)"}. Supported: Image: png/jpg/bmp/tga, Audio: mp3/ogg/wav/flac, Model: fbx/gltf/glb/rbxm/rbxmx, Video: mp4/mov`);
     }
     return mimeTypes[ext];
   }
@@ -1148,12 +1163,18 @@ var RobloxCookieClient = class {
     return response;
   }
   async uploadDecal(fileContent, name, description) {
+    return this.uploadAssetByTypeId(fileContent, name, description, 13, "Decal");
+  }
+  async uploadAudio(fileContent, name, description) {
+    return this.uploadAssetByTypeId(fileContent, name, description, 3, "Audio");
+  }
+  async uploadAssetByTypeId(fileContent, name, description, assetTypeId, assetLabel) {
     if (!this.cookie) {
       throw new Error("ROBLOSECURITY cookie is not set.");
     }
     const encodedName = encodeURIComponent(name);
     const encodedDesc = encodeURIComponent(description);
-    const url = `https://data.roblox.com/data/upload/json?assetTypeId=13&name=${encodedName}&description=${encodedDesc}`;
+    const url = `https://data.roblox.com/data/upload/json?assetTypeId=${assetTypeId}&name=${encodedName}&description=${encodedDesc}`;
     const response = await this.fetchWithCsrf(url, {
       method: "POST",
       headers: {
@@ -1165,11 +1186,11 @@ var RobloxCookieClient = class {
     });
     if (!response.ok) {
       const body = await response.text();
-      throw new Error(`Decal upload failed (${response.status}): ${body}`);
+      throw new Error(`${assetLabel} upload failed (${response.status}): ${body}`);
     }
     const result = await response.json();
     if (!result.Success || !result.AssetId) {
-      throw new Error(`Decal upload failed: ${result.Message || "Unknown error"}`);
+      throw new Error(`${assetLabel} upload failed: ${result.Message || "Unknown error"}`);
     }
     return {
       assetId: result.AssetId,
@@ -2531,6 +2552,59 @@ ${code}`
       }]
     };
   }
+  async uploadAsset(filePath, assetType, displayName, description, userId, groupId) {
+    if (!fs.existsSync(filePath)) {
+      throw new Error(`File not found: ${filePath}`);
+    }
+    const fileContent = fs.readFileSync(filePath);
+    const fileName = path.basename(filePath);
+    const cookieSupported = assetType === "Decal" || assetType === "Audio";
+    if (cookieSupported && this.cookieClient.hasCookie()) {
+      const upload = assetType === "Decal" ? this.cookieClient.uploadDecal(fileContent, displayName, description || "") : this.cookieClient.uploadAudio(fileContent, displayName, description || "");
+      const result2 = await upload;
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({
+            done: true,
+            response: {
+              assetId: String(result2.assetId),
+              displayName,
+              assetType,
+              backingAssetId: String(result2.backingAssetId)
+            }
+          })
+        }]
+      };
+    }
+    if (!this.openCloudClient.hasApiKey()) {
+      const cookieHint = cookieSupported ? " Alternatively, set ROBLOSECURITY to use cookie auth." : "";
+      throw new Error(`No auth configured for ${assetType} upload. Set ROBLOX_OPEN_CLOUD_API_KEY (needs asset:write scope).${cookieHint}`);
+    }
+    const resolvedGroupId = groupId || process.env.ROBLOX_CREATOR_GROUP_ID;
+    const resolvedUserId = userId || process.env.ROBLOX_CREATOR_USER_ID;
+    if (!resolvedUserId && !resolvedGroupId) {
+      throw new Error("Creator identity required for Open Cloud upload. Set ROBLOX_CREATOR_USER_ID or ROBLOX_CREATOR_GROUP_ID, or pass userId/groupId as parameters.");
+    }
+    const creator = {};
+    if (resolvedGroupId) {
+      creator.groupId = resolvedGroupId;
+    } else {
+      creator.userId = resolvedUserId;
+    }
+    const result = await this.openCloudClient.createAsset({
+      assetType,
+      displayName,
+      description: description || "",
+      creationContext: { creator }
+    }, fileContent, fileName);
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify(result)
+      }]
+    };
+  }
   async simulateMouseInput(action, x, y, button, scrollDirection, target) {
     if (!action) {
       throw new Error("action is required for simulate_mouse_input");
@@ -3015,6 +3089,8 @@ var RobloxStudioMCPServer = class {
             return await this.tools.previewAsset(args?.assetId, args?.includeProperties, args?.maxDepth);
           case "upload_decal":
             return await this.tools.uploadDecal(args?.filePath, args?.displayName, args?.description, args?.userId, args?.groupId);
+          case "upload_asset":
+            return await this.tools.uploadAsset(args?.filePath, args?.assetType, args?.displayName, args?.description, args?.userId, args?.groupId);
           case "clone_object":
             return await this.tools.cloneObject(args?.instancePath, args?.targetParentPath);
           case "move_object":
@@ -4511,6 +4587,42 @@ part(0,2,0,2,1,1,"b")`,
       required: ["filePath", "displayName"]
     }
   },
+  {
+    name: "upload_asset",
+    category: "write",
+    description: "Upload any supported asset type to Roblox: Audio (mp3/ogg/wav/flac), Decal (png/jpg/bmp/tga), Model (fbx/gltf/glb/rbxm/rbxmx), Animation (rbxm/rbxmx), or Video (mp4/mov). For Audio and Decal, supports ROBLOSECURITY cookie auth (recommended) or ROBLOX_OPEN_CLOUD_API_KEY. Other types require Open Cloud API key. Audio: max 7 min, 100 uploads/month (ID-verified). Video: max 5 min, requires 13+ ID-verified.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        filePath: {
+          type: "string",
+          description: "Absolute path to the file on disk"
+        },
+        assetType: {
+          type: "string",
+          enum: ["Audio", "Decal", "Model", "Animation", "Video"],
+          description: "Type of asset to upload. Must match the file format."
+        },
+        displayName: {
+          type: "string",
+          description: "Display name for the asset (max 50 characters)"
+        },
+        description: {
+          type: "string",
+          description: "Description for the asset (default: empty string)"
+        },
+        userId: {
+          type: "string",
+          description: "Roblox user ID for the asset creator. Overrides ROBLOX_CREATOR_USER_ID env var."
+        },
+        groupId: {
+          type: "string",
+          description: "Roblox group ID for the asset creator. Overrides ROBLOX_CREATOR_GROUP_ID env var. Takes precedence over userId if both provided."
+        }
+      },
+      required: ["filePath", "assetType", "displayName"]
+    }
+  },
   {
     name: "capture_screenshot",
     category: "read",

package/package.json

@@ -1,48 +1,48 @@
-{
-  "name": "robloxstudio-mcp",
-  "version": "2.6.0",
-  "description": "MCP Server for Roblox Studio Integration - Access Studio data, scripts, and objects through AI tools",
-  "main": "dist/index.js",
-  "type": "module",
-  "bin": {
-    "robloxstudio-mcp": "dist/index.js"
-  },
-  "files": [
-    "dist/**/*",
-    "studio-plugin/**/*"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "prepack": "node ../../scripts/prepack.mjs",
-    "postpack": "node ../../scripts/postpack.mjs"
-  },
-  "keywords": [
-    "mcp",
-    "roblox",
-    "studio",
-    "ai",
-    "model-context-protocol",
-    "game-development"
-  ],
-  "author": "",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/boshyxd/robloxstudio-mcp.git"
-  },
-  "homepage": "https://github.com/boshyxd/robloxstudio-mcp#readme",
-  "bugs": {
-    "url": "https://github.com/boshyxd/robloxstudio-mcp/issues"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1",
-    "cors": "^2.8.5",
-    "express": "^4.18.2",
-    "node-fetch": "^3.3.2",
-    "uuid": "^9.0.1",
-    "ws": "^8.14.2"
-  },
-  "devDependencies": {
-    "@robloxstudio-mcp/core": "*"
-  }
-}
+{
+  "name": "robloxstudio-mcp",
+  "version": "2.7.0-next.0",
+  "description": "MCP Server for Roblox Studio Integration - Access Studio data, scripts, and objects through AI tools",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "robloxstudio-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist/**/*",
+    "studio-plugin/**/*"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "prepack": "node ../../scripts/prepack.mjs",
+    "postpack": "node ../../scripts/postpack.mjs"
+  },
+  "keywords": [
+    "mcp",
+    "roblox",
+    "studio",
+    "ai",
+    "model-context-protocol",
+    "game-development"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/boshyxd/robloxstudio-mcp.git"
+  },
+  "homepage": "https://github.com/boshyxd/robloxstudio-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/boshyxd/robloxstudio-mcp/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "cors": "^2.8.5",
+    "express": "^4.18.2",
+    "node-fetch": "^3.3.2",
+    "uuid": "^9.0.1",
+    "ws": "^8.14.2"
+  },
+  "devDependencies": {
+    "@robloxstudio-mcp/core": "*"
+  }
+}