conduit-mcp 2.0.0

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { parseArgs } from \"node:util\";\nimport { homedir, platform } from \"node:os\";\nimport { join } from \"node:path\";\nimport { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { startServer } from \"./index.js\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nconst { values } = parseArgs({\n  options: {\n    install: { type: \"boolean\", default: false },\n    \"auto-config\": { type: \"boolean\", default: false },\n    port: { type: \"string\", default: \"3200\" },\n    mode: { type: \"string\", default: \"full\" },\n    \"with-cloud\": { type: \"boolean\", default: false },\n    \"with-rojo\": { type: \"boolean\", default: false },\n    version: { type: \"boolean\", default: false },\n    help: { type: \"boolean\", default: false },\n  },\n  strict: false,\n});\n\nif (values.version) {\n  const pkg = JSON.parse(\n    readFileSync(join(__dirname, \"..\", \"package.json\"), \"utf-8\"),\n  );\n  console.log(`conduit-mcp v${pkg.version}`);\n  process.exit(0);\n}\n\nif (values.help) {\n  console.log(`\nconduit-mcp — WebSocket-first MCP bridge for Roblox Studio\n\nUsage:\n  npx conduit-mcp              Start the MCP server (stdio transport)\n  npx conduit-mcp --install    Install the Studio plugin & show config\n  npx conduit-mcp --version    Print version\n\nOptions:\n  --install        Install the Conduit plugin to Roblox Studio\n  --auto-config    Also write config to detected AI clients\n  --port <number>  Override default bridge port (default: 3200)\n  --mode <mode>    Tool mode: 'full' (default) or 'inspector' (read-only tools only)\n  --with-cloud     Enable Cloud module (requires ROBLOX_CLOUD_API_KEY env var)\n  --with-rojo      Enable Rojo module (requires rojo on PATH)\n  --help           Show this help message\n`);\n  process.exit(0);\n}\n\nif (values.install) {\n  await install(values[\"auto-config\"] as boolean);\n  process.exit(0);\n}\n\n// Validate mode\nconst mode = (values.mode as string) || \"full\";\nif (mode !== \"full\" && mode !== \"inspector\") {\n  console.error(`Unknown mode: ${mode}. Expected 'full' or 'inspector'.`);\n  process.exit(1);\n}\n\n// Default: start the MCP server\nconst port = parseInt(values.port as string) || 3200;\nawait startServer(port, {\n  mode: mode as \"full\" | \"inspector\",\n  withCloud: values[\"with-cloud\"] as boolean,\n  withRojo: values[\"with-rojo\"] as boolean,\n});\n\n// ── Install logic ────────────────────────────────────────────────\n\nasync function install(autoConfig: boolean): Promise<void> {\n  console.log(\"Conduit MCP — Installation\\n\");\n\n  // Step 1: Install plugin\n  const pluginInstalled = installPlugin();\n\n  // Step 2: Detect & configure AI clients\n  const clients = detectClients();\n\n  if (clients.length === 0) {\n    console.log(\"No AI clients detected. Add this to your client's MCP config:\\n\");\n    printConfigSnippet();\n  } else {\n    console.log(`\\nDetected AI clients: ${clients.map((c) => c.name).join(\", \")}\\n`);\n\n    for (const client of clients) {\n      if (autoConfig) {\n        writeClientConfig(client);\n      } else {\n        console.log(`${client.name} — add this to ${client.configPath}:\\n`);\n        printConfigSnippet();\n      }\n    }\n  }\n\n  console.log(pluginInstalled ? \"\\nInstallation complete!\" : \"\\nPlugin installation failed — install manually from GitHub releases.\");\n  console.log(\"\\nNext steps:\");\n  console.log(\"  1. Open Roblox Studio\");\n  console.log(\"  2. Enable HttpService (Game Settings > Security > Allow HTTP Requests)\");\n  console.log(\"  3. The Conduit plugin will auto-connect when the MCP server starts\");\n}\n\nfunction installPlugin(): boolean {\n  const pluginSrc = join(__dirname, \"..\", \"plugin\", \"Conduit.rbxm\");\n\n  if (!existsSync(pluginSrc)) {\n    console.log(\"Plugin file not found at: \" + pluginSrc);\n    return false;\n  }\n\n  const pluginsDir = getPluginsDir();\n  if (!pluginsDir) {\n    console.log(\"Could not determine Roblox Studio plugins directory for this platform.\");\n    return false;\n  }\n\n  if (!existsSync(pluginsDir)) {\n    mkdirSync(pluginsDir, { recursive: true });\n  }\n\n  const dest = join(pluginsDir, \"Conduit.rbxm\");\n  copyFileSync(pluginSrc, dest);\n  console.log(`Plugin installed to: ${dest}`);\n  return true;\n}\n\nfunction getPluginsDir(): string | null {\n  const os = platform();\n  if (os === \"win32\") {\n    const localAppData = process.env.LOCALAPPDATA;\n    if (localAppData) {\n      return join(localAppData, \"Roblox\", \"Plugins\");\n    }\n    return join(homedir(), \"AppData\", \"Local\", \"Roblox\", \"Plugins\");\n  }\n  if (os === \"darwin\") {\n    return join(homedir(), \"Documents\", \"Roblox\", \"Plugins\");\n  }\n  return null;\n}\n\ninterface ClientInfo {\n  name: string;\n  configPath: string;\n  configKey: string;\n}\n\nfunction detectClients(): ClientInfo[] {\n  const home = homedir();\n  const candidates: ClientInfo[] = [\n    {\n      name: \"Claude Code\",\n      configPath: join(home, \".claude\", \"settings.json\"),\n      configKey: \"mcpServers\",\n    },\n    {\n      name: \"Cursor\",\n      configPath: join(home, \".cursor\", \"mcp.json\"),\n      configKey: \"mcpServers\",\n    },\n    {\n      name: \"Windsurf\",\n      configPath: join(home, \".windsurf\", \"mcp.json\"),\n      configKey: \"mcpServers\",\n    },\n    {\n      name: \"Claude Desktop (Windows)\",\n      configPath: join(\n        process.env.APPDATA || join(home, \"AppData\", \"Roaming\"),\n        \"Claude\",\n        \"claude_desktop_config.json\",\n      ),\n      configKey: \"mcpServers\",\n    },\n    {\n      name: \"Claude Desktop (macOS)\",\n      configPath: join(\n        home,\n        \"Library\",\n        \"Application Support\",\n        \"Claude\",\n        \"claude_desktop_config.json\",\n      ),\n      configKey: \"mcpServers\",\n    },\n  ];\n\n  return candidates.filter((c) => {\n    try {\n      return existsSync(dirname(c.configPath));\n    } catch {\n      return false;\n    }\n  });\n}\n\nfunction printConfigSnippet(): void {\n  const snippet = {\n    conduit: {\n      command: \"npx\",\n      args: [\"-y\", \"conduit-mcp\"],\n    },\n  };\n  console.log(JSON.stringify(snippet, null, 2));\n}\n\nfunction writeClientConfig(client: ClientInfo): void {\n  try {\n    let config: Record<string, unknown> = {};\n    if (existsSync(client.configPath)) {\n      config = JSON.parse(readFileSync(client.configPath, \"utf-8\"));\n    }\n\n    const servers = (config[client.configKey] as Record<string, unknown>) ?? {};\n    servers[\"conduit\"] = {\n      command: \"npx\",\n      args: [\"-y\", \"conduit-mcp\"],\n    };\n    config[client.configKey] = servers;\n\n    const dir = dirname(client.configPath);\n    if (!existsSync(dir)) {\n      mkdirSync(dir, { recursive: true });\n    }\n\n    writeFileSync(client.configPath, JSON.stringify(config, null, 2) + \"\\n\");\n    console.log(`${client.name} — config written to ${client.configPath}`);\n  } catch (err) {\n    console.log(`${client.name} — failed to write config: ${err}`);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/cloud-HQIBAMRL.js

@@ -0,0 +1,197 @@
+// src/modules/cloud.ts
+import { z } from "zod";
+var BASE_URL = "https://apis.roblox.com";
+function getApiKey() {
+  const key = process.env.ROBLOX_CLOUD_API_KEY;
+  if (!key) {
+    throw new Error(
+      "ROBLOX_CLOUD_API_KEY environment variable is not set. Get an API key from https://create.roblox.com/credentials"
+    );
+  }
+  return key;
+}
+async function cloudFetch(path, options = {}) {
+  const apiKey = getApiKey();
+  const url = `${BASE_URL}${path}`;
+  const res = await fetch(url, {
+    method: options.method ?? "GET",
+    headers: {
+      "x-api-key": apiKey,
+      "Content-Type": "application/json"
+    },
+    body: options.body ? JSON.stringify(options.body) : void 0
+  });
+  if (!res.ok) {
+    const text = await res.text();
+    throw new Error(`Cloud API error ${res.status}: ${text}`);
+  }
+  const contentType = res.headers.get("content-type") ?? "";
+  if (contentType.includes("application/json")) {
+    return res.json();
+  }
+  return res.text();
+}
+function register(server) {
+  server.registerTool(
+    "cloud",
+    {
+      title: "Roblox Open Cloud",
+      description: "Interact with the Roblox Open Cloud API. Requires ROBLOX_CLOUD_API_KEY env var.\n\nActions:\n- `datastore_get`: Read a key from a standard datastore.\n- `datastore_set`: Write a key to a standard datastore.\n- `datastore_list`: List keys in a standard datastore.\n- `messaging_publish`: Publish a message to a MessagingService topic.\n- `place_info`: Get information about a place.",
+      inputSchema: z.object({
+        action: z.enum([
+          "datastore_get",
+          "datastore_set",
+          "datastore_list",
+          "messaging_publish",
+          "place_info"
+        ]).describe("Cloud API action"),
+        universeId: z.number().int().describe("Roblox Universe ID"),
+        // Datastore params
+        datastoreName: z.string().optional().describe("Datastore name (for datastore actions)"),
+        key: z.string().optional().describe("Datastore entry key (for get/set)"),
+        value: z.unknown().optional().describe("Value to store (for datastore_set)"),
+        scope: z.string().optional().describe("Datastore scope (optional, default 'global')"),
+        prefix: z.string().optional().describe("Key prefix filter (for datastore_list)"),
+        limit: z.number().int().default(10).describe("Max results (for datastore_list)"),
+        // Messaging params
+        topic: z.string().optional().describe("MessagingService topic (for messaging_publish)"),
+        message: z.string().optional().describe("Message to publish (for messaging_publish)"),
+        // Place params
+        placeId: z.number().int().optional().describe("Place ID (for place_info)")
+      }),
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true
+      }
+    },
+    async (params) => {
+      const { universeId } = params;
+      if (params.action === "datastore_get") {
+        if (!params.datastoreName || !params.key) {
+          return {
+            content: [
+              { type: "text", text: "datastore_get requires `datastoreName` and `key`." }
+            ]
+          };
+        }
+        const scope = params.scope ?? "global";
+        const path = `/datastores/v1/universes/${universeId}/standard-datastores/datastore/entries/entry?datastoreName=${encodeURIComponent(params.datastoreName)}&entryKey=${encodeURIComponent(params.key)}&scope=${encodeURIComponent(scope)}`;
+        const result = await cloudFetch(path);
+        return {
+          content: [
+            {
+              type: "text",
+              text: `**${params.datastoreName}/${params.key}:**
+\`\`\`json
+${JSON.stringify(result, null, 2)}
+\`\`\``
+            }
+          ]
+        };
+      }
+      if (params.action === "datastore_set") {
+        if (!params.datastoreName || !params.key) {
+          return {
+            content: [
+              { type: "text", text: "datastore_set requires `datastoreName`, `key`, and `value`." }
+            ]
+          };
+        }
+        const scope = params.scope ?? "global";
+        const path = `/datastores/v1/universes/${universeId}/standard-datastores/datastore/entries/entry?datastoreName=${encodeURIComponent(params.datastoreName)}&entryKey=${encodeURIComponent(params.key)}&scope=${encodeURIComponent(scope)}`;
+        const result = await cloudFetch(path, {
+          method: "POST",
+          body: params.value
+        });
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Set **${params.datastoreName}/${params.key}** successfully.
+\`\`\`json
+${JSON.stringify(result, null, 2)}
+\`\`\``
+            }
+          ]
+        };
+      }
+      if (params.action === "datastore_list") {
+        if (!params.datastoreName) {
+          return {
+            content: [
+              { type: "text", text: "datastore_list requires `datastoreName`." }
+            ]
+          };
+        }
+        const scope = params.scope ?? "global";
+        let path = `/datastores/v1/universes/${universeId}/standard-datastores/datastore/entries?datastoreName=${encodeURIComponent(params.datastoreName)}&scope=${encodeURIComponent(scope)}&limit=${params.limit}`;
+        if (params.prefix) {
+          path += `&prefix=${encodeURIComponent(params.prefix)}`;
+        }
+        const result = await cloudFetch(path);
+        const keys = result.keys?.map((k) => k.key) ?? [];
+        return {
+          content: [
+            {
+              type: "text",
+              text: keys.length > 0 ? `**Keys in ${params.datastoreName}:**
+${keys.map((k) => `- \`${k}\``).join("\n")}` : `*No keys found in ${params.datastoreName}.*`
+            }
+          ]
+        };
+      }
+      if (params.action === "messaging_publish") {
+        if (!params.topic || !params.message) {
+          return {
+            content: [
+              { type: "text", text: "messaging_publish requires `topic` and `message`." }
+            ]
+          };
+        }
+        const path = `/messaging-service/v1/universes/${universeId}/topics/${encodeURIComponent(params.topic)}`;
+        await cloudFetch(path, {
+          method: "POST",
+          body: { message: params.message }
+        });
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Message published to topic **${params.topic}**.`
+            }
+          ]
+        };
+      }
+      if (params.action === "place_info") {
+        const placeId = params.placeId;
+        if (!placeId) {
+          return {
+            content: [
+              { type: "text", text: "place_info requires `placeId`." }
+            ]
+          };
+        }
+        const path = `/universes/v1/${universeId}/places/${placeId}`;
+        const result = await cloudFetch(path);
+        return {
+          content: [
+            {
+              type: "text",
+              text: `**Place info:**
+\`\`\`json
+${JSON.stringify(result, null, 2)}
+\`\`\``
+            }
+          ]
+        };
+      }
+      return { content: [{ type: "text", text: "Unknown cloud action." }] };
+    }
+  );
+}
+export {
+  register
+};
+//# sourceMappingURL=cloud-HQIBAMRL.js.map

package/dist/cloud-HQIBAMRL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/modules/cloud.ts"],"sourcesContent":["import { z } from \"zod\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { log } from \"../utils/logger.js\";\n\nconst BASE_URL = \"https://apis.roblox.com\";\n\nfunction getApiKey(): string {\n  const key = process.env.ROBLOX_CLOUD_API_KEY;\n  if (!key) {\n    throw new Error(\n      \"ROBLOX_CLOUD_API_KEY environment variable is not set. \" +\n        \"Get an API key from https://create.roblox.com/credentials\",\n    );\n  }\n  return key;\n}\n\nasync function cloudFetch(\n  path: string,\n  options: { method?: string; body?: unknown } = {},\n): Promise<unknown> {\n  const apiKey = getApiKey();\n  const url = `${BASE_URL}${path}`;\n  const res = await fetch(url, {\n    method: options.method ?? \"GET\",\n    headers: {\n      \"x-api-key\": apiKey,\n      \"Content-Type\": \"application/json\",\n    },\n    body: options.body ? JSON.stringify(options.body) : undefined,\n  });\n\n  if (!res.ok) {\n    const text = await res.text();\n    throw new Error(`Cloud API error ${res.status}: ${text}`);\n  }\n\n  const contentType = res.headers.get(\"content-type\") ?? \"\";\n  if (contentType.includes(\"application/json\")) {\n    return res.json();\n  }\n  return res.text();\n}\n\nexport function register(server: McpServer): void {\n  server.registerTool(\n    \"cloud\",\n    {\n      title: \"Roblox Open Cloud\",\n      description:\n        \"Interact with the Roblox Open Cloud API. Requires ROBLOX_CLOUD_API_KEY env var.\\n\\n\" +\n        \"Actions:\\n\" +\n        \"- `datastore_get`: Read a key from a standard datastore.\\n\" +\n        \"- `datastore_set`: Write a key to a standard datastore.\\n\" +\n        \"- `datastore_list`: List keys in a standard datastore.\\n\" +\n        \"- `messaging_publish`: Publish a message to a MessagingService topic.\\n\" +\n        \"- `place_info`: Get information about a place.\",\n      inputSchema: z.object({\n        action: z\n          .enum([\n            \"datastore_get\",\n            \"datastore_set\",\n            \"datastore_list\",\n            \"messaging_publish\",\n            \"place_info\",\n          ])\n          .describe(\"Cloud API action\"),\n        universeId: z.number().int().describe(\"Roblox Universe ID\"),\n        // Datastore params\n        datastoreName: z\n          .string()\n          .optional()\n          .describe(\"Datastore name (for datastore actions)\"),\n        key: z\n          .string()\n          .optional()\n          .describe(\"Datastore entry key (for get/set)\"),\n        value: z\n          .unknown()\n          .optional()\n          .describe(\"Value to store (for datastore_set)\"),\n        scope: z\n          .string()\n          .optional()\n          .describe(\"Datastore scope (optional, default 'global')\"),\n        prefix: z\n          .string()\n          .optional()\n          .describe(\"Key prefix filter (for datastore_list)\"),\n        limit: z\n          .number()\n          .int()\n          .default(10)\n          .describe(\"Max results (for datastore_list)\"),\n        // Messaging params\n        topic: z\n          .string()\n          .optional()\n          .describe(\"MessagingService topic (for messaging_publish)\"),\n        message: z\n          .string()\n          .optional()\n          .describe(\"Message to publish (for messaging_publish)\"),\n        // Place params\n        placeId: z\n          .number()\n          .int()\n          .optional()\n          .describe(\"Place ID (for place_info)\"),\n      }),\n      annotations: {\n        readOnlyHint: false,\n        destructiveHint: false,\n        idempotentHint: false,\n        openWorldHint: true,\n      },\n    },\n    async (params) => {\n      const { universeId } = params;\n\n      if (params.action === \"datastore_get\") {\n        if (!params.datastoreName || !params.key) {\n          return {\n            content: [\n              { type: \"text\", text: \"datastore_get requires `datastoreName` and `key`.\" },\n            ],\n          };\n        }\n        const scope = params.scope ?? \"global\";\n        const path = `/datastores/v1/universes/${universeId}/standard-datastores/datastore/entries/entry?datastoreName=${encodeURIComponent(params.datastoreName)}&entryKey=${encodeURIComponent(params.key)}&scope=${encodeURIComponent(scope)}`;\n        const result = await cloudFetch(path);\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `**${params.datastoreName}/${params.key}:**\\n\\`\\`\\`json\\n${JSON.stringify(result, null, 2)}\\n\\`\\`\\``,\n            },\n          ],\n        };\n      }\n\n      if (params.action === \"datastore_set\") {\n        if (!params.datastoreName || !params.key) {\n          return {\n            content: [\n              { type: \"text\", text: \"datastore_set requires `datastoreName`, `key`, and `value`.\" },\n            ],\n          };\n        }\n        const scope = params.scope ?? \"global\";\n        const path = `/datastores/v1/universes/${universeId}/standard-datastores/datastore/entries/entry?datastoreName=${encodeURIComponent(params.datastoreName)}&entryKey=${encodeURIComponent(params.key)}&scope=${encodeURIComponent(scope)}`;\n        const result = await cloudFetch(path, {\n          method: \"POST\",\n          body: params.value,\n        });\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `Set **${params.datastoreName}/${params.key}** successfully.\\n\\`\\`\\`json\\n${JSON.stringify(result, null, 2)}\\n\\`\\`\\``,\n            },\n          ],\n        };\n      }\n\n      if (params.action === \"datastore_list\") {\n        if (!params.datastoreName) {\n          return {\n            content: [\n              { type: \"text\", text: \"datastore_list requires `datastoreName`.\" },\n            ],\n          };\n        }\n        const scope = params.scope ?? \"global\";\n        let path = `/datastores/v1/universes/${universeId}/standard-datastores/datastore/entries?datastoreName=${encodeURIComponent(params.datastoreName)}&scope=${encodeURIComponent(scope)}&limit=${params.limit}`;\n        if (params.prefix) {\n          path += `&prefix=${encodeURIComponent(params.prefix)}`;\n        }\n        const result = (await cloudFetch(path)) as { keys?: Array<{ key: string }> };\n        const keys = result.keys?.map((k) => k.key) ?? [];\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: keys.length > 0\n                ? `**Keys in ${params.datastoreName}:**\\n${keys.map((k) => `- \\`${k}\\``).join(\"\\n\")}`\n                : `*No keys found in ${params.datastoreName}.*`,\n            },\n          ],\n        };\n      }\n\n      if (params.action === \"messaging_publish\") {\n        if (!params.topic || !params.message) {\n          return {\n            content: [\n              { type: \"text\", text: \"messaging_publish requires `topic` and `message`.\" },\n            ],\n          };\n        }\n        const path = `/messaging-service/v1/universes/${universeId}/topics/${encodeURIComponent(params.topic)}`;\n        await cloudFetch(path, {\n          method: \"POST\",\n          body: { message: params.message },\n        });\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `Message published to topic **${params.topic}**.`,\n            },\n          ],\n        };\n      }\n\n      if (params.action === \"place_info\") {\n        const placeId = params.placeId;\n        if (!placeId) {\n          return {\n            content: [\n              { type: \"text\", text: \"place_info requires `placeId`.\" },\n            ],\n          };\n        }\n        const path = `/universes/v1/${universeId}/places/${placeId}`;\n        const result = await cloudFetch(path);\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `**Place info:**\\n\\`\\`\\`json\\n${JSON.stringify(result, null, 2)}\\n\\`\\`\\``,\n            },\n          ],\n        };\n      }\n\n      return { content: [{ type: \"text\", text: \"Unknown cloud action.\" }] };\n    },\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/index.js

@@ -0,0 +1,7 @@
+import {
+  startServer
+} from "./chunk-JDWBW44K.js";
+export {
+  startServer
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/rojo-TXV4K4PB.js

@@ -0,0 +1,112 @@
+// src/modules/rojo.ts
+import { z } from "zod";
+import { execFile } from "child_process";
+import { promisify } from "util";
+var execFileAsync = promisify(execFile);
+async function runRojo(args, cwd) {
+  try {
+    return await execFileAsync("rojo", args, {
+      cwd,
+      timeout: 3e4
+    });
+  } catch (err) {
+    if (err.code === "ENOENT") {
+      throw new Error(
+        "rojo command not found. Install it with: cargo install rojo, or via aftman/foreman."
+      );
+    }
+    throw new Error(`rojo ${args.join(" ")} failed: ${err.stderr || err.message}`);
+  }
+}
+function register(server) {
+  server.registerTool(
+    "rojo",
+    {
+      title: "Rojo Integration",
+      description: "Interact with Rojo for filesystem <-> Studio syncing. Requires `rojo` on PATH.\n\nActions:\n- `sourcemap`: Generate a sourcemap JSON showing Studio <-> filesystem mapping.\n- `build`: Build a .rbxm/.rbxmx/.rbxl file from a Rojo project.\n- `version`: Show installed Rojo version.",
+      inputSchema: z.object({
+        action: z.enum(["sourcemap", "build", "version"]).describe("Rojo action"),
+        project: z.string().optional().describe("Path to .project.json file (defaults to default.project.json in cwd)"),
+        output: z.string().optional().describe("Output file path (for 'build' action)")
+      }),
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false
+      }
+    },
+    async (params) => {
+      if (params.action === "version") {
+        const { stdout } = await runRojo(["--version"]);
+        return {
+          content: [{ type: "text", text: stdout.trim() }]
+        };
+      }
+      if (params.action === "sourcemap") {
+        const args = ["sourcemap"];
+        if (params.project) {
+          args.push(params.project);
+        }
+        args.push("--output", "-");
+        const { stdout } = await runRojo(args);
+        try {
+          const sourcemap = JSON.parse(stdout);
+          const summary = formatSourcemap(sourcemap);
+          return {
+            content: [{ type: "text", text: summary }]
+          };
+        } catch {
+          return {
+            content: [{ type: "text", text: `**Raw sourcemap:**
+\`\`\`json
+${stdout}
+\`\`\`` }]
+          };
+        }
+      }
+      if (params.action === "build") {
+        if (!params.output) {
+          return {
+            content: [{ type: "text", text: "build action requires an `output` path." }]
+          };
+        }
+        const args = ["build"];
+        if (params.project) {
+          args.push(params.project);
+        }
+        args.push("--output", params.output);
+        const { stdout, stderr } = await runRojo(args);
+        const message = stdout || stderr || "Build completed.";
+        return {
+          content: [
+            { type: "text", text: `Rojo build complete: **${params.output}**
+${message.trim()}` }
+          ]
+        };
+      }
+      return { content: [{ type: "text", text: "Unknown rojo action." }] };
+    }
+  );
+}
+function formatSourcemap(sourcemap, depth = 0, indent = "") {
+  if (!sourcemap || !sourcemap.name) return "";
+  let line = `${indent}- **${sourcemap.name}** \`${sourcemap.className ?? ""}\``;
+  if (sourcemap.filePaths && sourcemap.filePaths.length > 0) {
+    line += ` \u2192 ${sourcemap.filePaths[0]}`;
+  }
+  let result = line + "\n";
+  if (sourcemap.children && depth < 3) {
+    for (const child of sourcemap.children) {
+      result += formatSourcemap(child, depth + 1, indent + "  ");
+    }
+  } else if (sourcemap.children && sourcemap.children.length > 0) {
+    result += `${indent}  *\u2026 ${sourcemap.children.length} children*
+`;
+  }
+  return result;
+}
+export {
+  register
+};
+//# sourceMappingURL=rojo-TXV4K4PB.js.map

package/dist/rojo-TXV4K4PB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/modules/rojo.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { execFile } from \"node:child_process\";\nimport { promisify } from \"node:util\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { log } from \"../utils/logger.js\";\n\nconst execFileAsync = promisify(execFile);\n\nasync function runRojo(\n  args: string[],\n  cwd?: string,\n): Promise<{ stdout: string; stderr: string }> {\n  try {\n    return await execFileAsync(\"rojo\", args, {\n      cwd,\n      timeout: 30_000,\n    });\n  } catch (err: any) {\n    if (err.code === \"ENOENT\") {\n      throw new Error(\n        \"rojo command not found. Install it with: cargo install rojo, or via aftman/foreman.\",\n      );\n    }\n    throw new Error(`rojo ${args.join(\" \")} failed: ${err.stderr || err.message}`);\n  }\n}\n\nexport function register(server: McpServer): void {\n  server.registerTool(\n    \"rojo\",\n    {\n      title: \"Rojo Integration\",\n      description:\n        \"Interact with Rojo for filesystem <-> Studio syncing. Requires `rojo` on PATH.\\n\\n\" +\n        \"Actions:\\n\" +\n        \"- `sourcemap`: Generate a sourcemap JSON showing Studio <-> filesystem mapping.\\n\" +\n        \"- `build`: Build a .rbxm/.rbxmx/.rbxl file from a Rojo project.\\n\" +\n        \"- `version`: Show installed Rojo version.\",\n      inputSchema: z.object({\n        action: z\n          .enum([\"sourcemap\", \"build\", \"version\"])\n          .describe(\"Rojo action\"),\n        project: z\n          .string()\n          .optional()\n          .describe(\"Path to .project.json file (defaults to default.project.json in cwd)\"),\n        output: z\n          .string()\n          .optional()\n          .describe(\"Output file path (for 'build' action)\"),\n      }),\n      annotations: {\n        readOnlyHint: true,\n        destructiveHint: false,\n        idempotentHint: true,\n        openWorldHint: false,\n      },\n    },\n    async (params) => {\n      if (params.action === \"version\") {\n        const { stdout } = await runRojo([\"--version\"]);\n        return {\n          content: [{ type: \"text\", text: stdout.trim() }],\n        };\n      }\n\n      if (params.action === \"sourcemap\") {\n        const args = [\"sourcemap\"];\n        if (params.project) {\n          args.push(params.project);\n        }\n        args.push(\"--output\", \"-\"); // Output to stdout\n        const { stdout } = await runRojo(args);\n        try {\n          const sourcemap = JSON.parse(stdout);\n          const summary = formatSourcemap(sourcemap);\n          return {\n            content: [{ type: \"text\", text: summary }],\n          };\n        } catch {\n          return {\n            content: [{ type: \"text\", text: `**Raw sourcemap:**\\n\\`\\`\\`json\\n${stdout}\\n\\`\\`\\`` }],\n          };\n        }\n      }\n\n      if (params.action === \"build\") {\n        if (!params.output) {\n          return {\n            content: [{ type: \"text\", text: \"build action requires an `output` path.\" }],\n          };\n        }\n        const args = [\"build\"];\n        if (params.project) {\n          args.push(params.project);\n        }\n        args.push(\"--output\", params.output);\n        const { stdout, stderr } = await runRojo(args);\n        const message = stdout || stderr || \"Build completed.\";\n        return {\n          content: [\n            { type: \"text\", text: `Rojo build complete: **${params.output}**\\n${message.trim()}` },\n          ],\n        };\n      }\n\n      return { content: [{ type: \"text\", text: \"Unknown rojo action.\" }] };\n    },\n  );\n}\n\nfunction formatSourcemap(sourcemap: any, depth = 0, indent = \"\"): string {\n  if (!sourcemap || !sourcemap.name) return \"\";\n\n  let line = `${indent}- **${sourcemap.name}** \\`${sourcemap.className ?? \"\"}\\``;\n  if (sourcemap.filePaths && sourcemap.filePaths.length > 0) {\n    line += ` → ${sourcemap.filePaths[0]}`;\n  }\n\n  let result = line + \"\\n\";\n\n  if (sourcemap.children && depth < 3) {\n    for (const child of sourcemap.children) {\n      result += formatSourcemap(child, depth + 1, indent + \"  \");\n    }\n  } else if (sourcemap.children && sourcemap.children.length > 0) {\n    result += `${indent}  *… ${sourcemap.children.length} children*\\n`;\n  }\n\n  return result;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "conduit-mcp",
+  "version": "2.0.0",
+  "description": "WebSocket-first MCP bridge between AI coding assistants and Roblox Studio",
+  "type": "module",
+  "bin": {
+    "conduit-mcp": "dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist/",
+    "plugin/Conduit.rbxm"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "ws": "^8.18.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.0",
+    "tsup": "^8.3.0",
+    "vitest": "^3.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "roblox",
+    "roblox-studio",
+    "ai",
+    "websocket",
+    "claude",
+    "cursor",
+    "windsurf"
+  ],
+  "author": "Henri Elliott-Knight <henri@knightco.digital>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/henri-knightco/conduit-mcp.git"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}