@usergenerated/rbx-iris 0.3.124

package/README.md

@@ -0,0 +1,61 @@
+[![CI](https://github.com/UserGeneratedLLC/rbx-iris/actions/workflows/ci.yml/badge.svg)](https://github.com/UserGeneratedLLC/rbx-iris/actions/workflows/ci.yml)
+[![Release](https://github.com/UserGeneratedLLC/rbx-iris/actions/workflows/release.yml/badge.svg)](https://github.com/UserGeneratedLLC/rbx-iris/actions/workflows/release.yml)
+[![npm](https://img.shields.io/npm/v/@usergenerated/rbx-iris)](https://www.npmjs.com/package/@usergenerated/rbx-iris)
+[![crates.io](https://img.shields.io/crates/v/rbx-iris)](https://crates.io/crates/rbx-iris)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](https://github.com/UserGeneratedLLC/rbx-iris/blob/main/LICENSE)
+
+# @usergenerated/rbx-iris
+
+npm wrapper for [Iris](https://github.com/UserGeneratedLLC/rbx-iris). Automatically downloads the correct pre-built binary for your platform from GitHub Releases.
+
+74 tools across scripting, instances, properties, attributes, transforms, camera, spatial queries, selections, history, collision groups, screenshots, execution, logging, and studio management — all over msgpack/WebSocket with multi-studio session routing.
+
+## Quick Setup
+
+Requires [Node.js](https://nodejs.org/) 18+ and [Roblox Studio](https://create.roblox.com/).
+
+### Cursor (`.cursor/mcp.json`)
+
+```json
+{
+  "mcpServers": {
+    "Iris": {
+      "command": "npx",
+      "args": ["-y", "--prefer-online", "@usergenerated/rbx-iris@latest", "--stdio", "--unsafe-reads", "--unsafe-writes"]
+    }
+  }
+}
+```
+
+### Claude Desktop (`claude_desktop_config.json`)
+
+```json
+{
+  "mcpServers": {
+    "Iris": {
+      "command": "npx",
+      "args": ["-y", "--prefer-online", "@usergenerated/rbx-iris@latest", "--stdio", "--unsafe-reads", "--unsafe-writes"]
+    }
+  }
+}
+```
+
+### Claude Code
+
+```sh
+claude mcp add --transport stdio Iris -- npx -y --prefer-online @usergenerated/rbx-iris@latest --stdio --unsafe-reads --unsafe-writes
+```
+
+Restart your MCP client and Roblox Studio after setup.
+
+## Supported Platforms
+
+| OS | Architecture |
+|---|---|
+| Windows | x64, ARM64 |
+| macOS | x64, ARM64 |
+| Linux | x64, ARM64 |
+
+## License
+
+[MIT](https://github.com/UserGeneratedLLC/rbx-iris/blob/main/LICENSE)

package/bin/cli.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+"use strict";
+
+const path = require("path");
+const { spawn } = require("child_process");
+
+const BIN_NAME = "rbx-iris";
+const exe =
+  process.platform === "win32" ? `${BIN_NAME}.exe` : BIN_NAME;
+const binPath = path.join(__dirname, exe);
+
+const child = spawn(binPath, process.argv.slice(2), {
+  stdio: "inherit",
+});
+
+child.on("error", (err) => {
+  if (err.code === "ENOENT") {
+    console.error(
+      `${BIN_NAME} binary not found at ${binPath}\n` +
+        "Run 'npm install' or reinstall the package to download it."
+    );
+  } else {
+    console.error(`Failed to start ${BIN_NAME}: ${err.message}`);
+  }
+  process.exit(1);
+});
+
+child.on("exit", (code) => {
+  process.exit(code ?? 1);
+});

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@usergenerated/rbx-iris",
+  "version": "0.3.124",
+  "description": "Iris — Roblox Studio MCP server, auto-downloads the correct platform binary from GitHub releases",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/UserGeneratedLLC/rbx-iris"
+  },
+  "bin": {
+    "rbx-iris": "bin/cli.js"
+  },
+  "scripts": {
+    "postinstall": "node postinstall.js"
+  },
+  "files": [
+    "bin/cli.js",
+    "postinstall.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}

package/postinstall.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+"use strict";
+
+const https = require("https");
+const fs = require("fs");
+const path = require("path");
+const { execSync } = require("child_process");
+const os = require("os");
+
+const REPO = "UserGeneratedLLC/rbx-iris";
+const BIN_NAME = "rbx-iris";
+
+const PLATFORM_MAP = {
+  "darwin-arm64": "macos-aarch64",
+  "darwin-x64": "macos-x86_64",
+  "linux-arm64": "linux-aarch64",
+  "linux-x64": "linux-x86_64",
+  "win32-arm64": "windows-aarch64",
+  "win32-x64": "windows-x86_64",
+};
+
+function getBinPath() {
+  const exe = process.platform === "win32" ? `${BIN_NAME}.exe` : BIN_NAME;
+  return path.join(__dirname, "bin", exe);
+}
+
+function getPlatformLabel() {
+  const key = `${process.platform}-${process.arch}`;
+  const label = PLATFORM_MAP[key];
+  if (!label) {
+    throw new Error(
+      `Unsupported platform: ${process.platform} ${process.arch}\n` +
+        `Supported: ${Object.keys(PLATFORM_MAP).join(", ")}`
+    );
+  }
+  return label;
+}
+
+function getVersion() {
+  const pkg = JSON.parse(
+    fs.readFileSync(path.join(__dirname, "package.json"), "utf8")
+  );
+  return pkg.version;
+}
+
+function httpsGet(url) {
+  return new Promise((resolve, reject) => {
+    https
+      .get(url, { headers: { "User-Agent": "rbx-iris-npm" } }, (res) => {
+        if (res.statusCode === 302 || res.statusCode === 301) {
+          httpsGet(res.headers.location).then(resolve, reject);
+          return;
+        }
+        if (res.statusCode !== 200) {
+          reject(
+            new Error(`Download failed: HTTP ${res.statusCode} from ${url}`)
+          );
+          return;
+        }
+        const chunks = [];
+        res.on("data", (chunk) => chunks.push(chunk));
+        res.on("end", () => resolve(Buffer.concat(chunks)));
+        res.on("error", reject);
+      })
+      .on("error", reject);
+  });
+}
+
+function extract(zipPath, destDir) {
+  try {
+    execSync(`tar -xf "${zipPath}" -C "${destDir}"`, { stdio: "pipe" });
+    return;
+  } catch (_) {
+    // tar failed, try fallback
+  }
+
+  if (process.platform === "win32") {
+    try {
+      execSync(
+        `powershell -NoProfile -Command "Expand-Archive -Force -Path '${zipPath}' -DestinationPath '${destDir}'"`,
+        { stdio: "pipe" }
+      );
+      return;
+    } catch (_) {
+      // fallback also failed
+    }
+  }
+
+  throw new Error(
+    "Extraction failed: neither tar nor PowerShell could extract the archive"
+  );
+}
+
+async function main() {
+  const binPath = getBinPath();
+
+  if (fs.existsSync(binPath)) {
+    console.log(`Binary already exists at ${binPath}, skipping download.`);
+    return;
+  }
+
+  const version = getVersion();
+  const label = getPlatformLabel();
+  const assetName = `${BIN_NAME}-${version}-${label}.zip`;
+  const url = `https://github.com/${REPO}/releases/download/v${version}/${assetName}`;
+
+  console.log(`Downloading ${BIN_NAME} v${version} for ${label}...`);
+
+  const zipBuffer = await httpsGet(url);
+
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "rbx-iris-"));
+  const zipPath = path.join(tmpDir, assetName);
+  const binDir = path.join(__dirname, "bin");
+
+  try {
+    fs.writeFileSync(zipPath, zipBuffer);
+    fs.mkdirSync(binDir, { recursive: true });
+    extract(zipPath, binDir);
+
+    if (process.platform !== "win32") {
+      fs.chmodSync(binPath, 0o755);
+    }
+
+    if (!fs.existsSync(binPath)) {
+      throw new Error(
+        `Extraction succeeded but binary not found at ${binPath}`
+      );
+    }
+
+    console.log(`Installed ${BIN_NAME} v${version} to ${binPath}`);
+  } finally {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  }
+}
+
+main().catch((err) => {
+  console.error(`Failed to install ${BIN_NAME}: ${err.message}`);
+  process.exit(1);
+});