robloxstudio-mcp 1.0.0

package/CLAUDE.md

@@ -0,0 +1,63 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Development Commands
+
+- `npm run dev` - Start development server with hot reload using tsx
+- `npm run build` - Build TypeScript to JavaScript in dist/
+- `npm start` - Run the built MCP server (requires build first)
+- `npm run lint` - Run ESLint on TypeScript source files
+- `npm run typecheck` - Run TypeScript compiler without emitting files
+
+## Architecture Overview
+
+This is a dual-component system that bridges Roblox Studio with MCP (Model Context Protocol) for AI tool integration:
+
+### Core Components
+
+1. **MCP Server** (`src/index.ts`): Stdio-based MCP server that exposes 15 tools for Studio data access
+2. **Bridge Service** (`src/bridge-service.ts`): Request/response queue manager using Promise-based async handling with UUID tracking
+3. **Studio Plugin** (`studio-plugin/plugin.lua`): Luau plugin that polls the HTTP server and executes Studio API calls
+4. **HTTP Server** (`src/http-server.ts`): Express server on port 3002 providing polling endpoints for the Studio plugin
+
+### Communication Flow
+
+The system uses a polling architecture because Roblox plugins cannot run HTTP servers:
+
+1. AI tools call MCP server via stdio
+2. MCP server queues requests in BridgeService 
+3. Studio plugin polls `/poll` endpoint every 500ms
+4. Plugin processes requests using Studio APIs
+5. Plugin sends responses via `/response` endpoint
+6. BridgeService resolves promises and returns data to MCP tools
+
+### Key Design Patterns
+
+- **Async Bridge Pattern**: BridgeService uses Map<string, PendingRequest> to track requests with Promise resolve/reject
+- **Polling Architecture**: Studio plugin maintains connection state and polls for work rather than receiving pushes
+- **Tool Proxy Pattern**: Each MCP tool proxies through HTTP to Studio plugin endpoints
+- **Timeout Management**: 30-second request timeouts with periodic cleanup
+
+### Tool Categories
+
+All 15 tools follow the same request/response pattern but are organized into:
+- File System Tools (file tree, content, search, properties)
+- Studio Context Tools (place info, services, selection, object search)  
+- Property & Instance Tools (instance data, children, property search, class info)
+- Project Tools (structure, dependencies, reference validation)
+
+### Studio Plugin Integration
+
+The plugin uses proper Roblox Studio APIs:
+- `plugin:CreateToolbar()` and `plugin:CreateDockWidgetPluginGui()` for UI
+- `HttpService:RequestAsync()` for HTTP communication
+- `RunService.Heartbeat` for polling timer
+- Studio services (Selection, StudioService, etc.) for data extraction
+
+### Build System
+
+- TypeScript with ES modules (`"type": "module"`)
+- ESLint with TypeScript parser
+- Builds to `dist/` directory
+- Uses tsx for development hot reload

package/README.md

@@ -0,0 +1,104 @@
+# Roblox Studio MCP Server
+
+An MCP (Model Context Protocol) server that provides AI tools access to Roblox Studio data through a plugin-based architecture.
+
+## Quick Installation
+
+### For End Users (Easy Setup)
+
+Add to your MCP configuration (like in Claude Desktop or other MCP clients):
+
+```json
+{
+  "mcpServers": {
+    "robloxstudio": {
+      "command": "npx",
+      "args": ["-y", "robloxstudio-mcp"],
+      "description": "Roblox Studio integration for AI assistants"
+    }
+  }
+}
+```
+
+Or use with Claude Code MCP add command:
+```bash
+claude mcp add robloxstudio -- npx -y robloxstudio-mcp
+```
+
+### For Developers
+
+1. **Clone and install:**
+   ```bash
+   git clone <repo-url>
+   cd robloxstudio-mcp
+   npm install
+   ```
+
+2. **Build and test:**
+   ```bash
+   npm run build
+   npm start
+   ```
+
+## Studio Plugin Setup
+
+**Required for both installation methods:**
+
+1. **Install the Studio plugin:**
+   - See [studio-plugin/INSTALLATION.md](studio-plugin/INSTALLATION.md) for detailed instructions
+   - Enable HTTP Requests in Game Settings
+   - Activate the plugin using the toolbar button
+
+## Architecture
+
+- **MCP Server** (TypeScript/Node.js) - Handles AI tool calls via stdio
+- **Studio Plugin** (Luau) - Extracts Studio data and communicates with MCP server
+- **HTTP Bridge** - Communication layer between plugin and server (localhost:3002)
+
+## Development
+
+- `npm run dev` - Start development server with hot reload
+- `npm run build` - Build TypeScript to JavaScript
+- `npm run lint` - Run ESLint
+- `npm run typecheck` - Run TypeScript type checking
+
+## Available Tools
+
+### File System Tools
+- `get_file_tree` - Complete hierarchy with script types, models, folders
+- `get_file_content` - Retrieve script source code
+- `search_files` - Find files by name, type, or content patterns
+- `get_file_properties` - Script properties, parent/child relationships
+
+### Studio Context Tools
+- `get_place_info` - Place ID, name, game settings
+- `get_services` - Available Roblox services and their children
+- `get_selection` - Currently selected objects in Studio
+- `search_objects` - Find instances by name, class, properties
+
+### Property & Instance Tools
+- `get_instance_properties` - All properties of a specific instance
+- `get_instance_children` - Child objects and their types
+- `search_by_property` - Find objects with specific property values
+- `get_class_info` - Available properties/methods for Roblox classes
+
+### Project Tools
+- `get_project_structure` - Complete game hierarchy
+- `get_dependencies` - Module dependencies and relationships
+- `validate_references` - Check for broken script references
+
+## Communication Protocol
+
+The MCP server exposes tools via stdio for AI integration. The Studio plugin polls the server on port 3002 using HTTP requests. When an AI tool is called:
+
+1. MCP server queues the request
+2. Studio plugin polls and receives the request
+3. Plugin extracts data using Studio APIs
+4. Plugin sends response back to server
+5. Server returns result to AI tool
+
+## Configuration
+
+The server can be configured through environment variables:
+- `MCP_SERVER_PORT` - Server port (default: 3001)
+- `STUDIO_PLUGIN_URL` - Studio plugin URL (default: http://localhost:3002)

package/dist/bridge-service.d.ts

@@ -0,0 +1,16 @@
+export declare class BridgeService {
+    private pendingRequests;
+    private requestTimeout;
+    sendRequest(endpoint: string, data: any): Promise<any>;
+    getPendingRequest(): {
+        requestId: string;
+        request: {
+            endpoint: string;
+            data: any;
+        };
+    } | null;
+    resolveRequest(requestId: string, response: any): void;
+    rejectRequest(requestId: string, error: any): void;
+    cleanupOldRequests(): void;
+}
+//# sourceMappingURL=bridge-service.d.ts.map

package/dist/bridge-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-service.d.ts","sourceRoot":"","sources":["../src/bridge-service.ts"],"names":[],"mappings":"AAWA,qBAAa,aAAa;IACxB,OAAO,CAAC,eAAe,CAA0C;IACjE,OAAO,CAAC,cAAc,CAAS;IAEzB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAyB5D,iBAAiB,IAAI;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,GAAG,CAAA;SAAE,CAAA;KAAE,GAAG,IAAI;IAuB3F,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG;IAQ/C,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;IAS3C,kBAAkB;CASnB"}

package/dist/bridge-service.js

@@ -0,0 +1,70 @@
+import { v4 as uuidv4 } from 'uuid';
+export class BridgeService {
+    pendingRequests = new Map();
+    requestTimeout = 30000; // 30 seconds timeout
+    async sendRequest(endpoint, data) {
+        const requestId = uuidv4();
+        return new Promise((resolve, reject) => {
+            const request = {
+                id: requestId,
+                endpoint,
+                data,
+                timestamp: Date.now(),
+                resolve,
+                reject
+            };
+            this.pendingRequests.set(requestId, request);
+            // Set timeout
+            setTimeout(() => {
+                if (this.pendingRequests.has(requestId)) {
+                    this.pendingRequests.delete(requestId);
+                    reject(new Error('Request timeout'));
+                }
+            }, this.requestTimeout);
+        });
+    }
+    getPendingRequest() {
+        // Get oldest pending request
+        let oldestRequest = null;
+        for (const request of this.pendingRequests.values()) {
+            if (!oldestRequest || request.timestamp < oldestRequest.timestamp) {
+                oldestRequest = request;
+            }
+        }
+        if (oldestRequest) {
+            return {
+                requestId: oldestRequest.id,
+                request: {
+                    endpoint: oldestRequest.endpoint,
+                    data: oldestRequest.data
+                }
+            };
+        }
+        return null;
+    }
+    resolveRequest(requestId, response) {
+        const request = this.pendingRequests.get(requestId);
+        if (request) {
+            this.pendingRequests.delete(requestId);
+            request.resolve(response);
+        }
+    }
+    rejectRequest(requestId, error) {
+        const request = this.pendingRequests.get(requestId);
+        if (request) {
+            this.pendingRequests.delete(requestId);
+            request.reject(error);
+        }
+    }
+    // Clean up old requests
+    cleanupOldRequests() {
+        const now = Date.now();
+        for (const [id, request] of this.pendingRequests.entries()) {
+            if (now - request.timestamp > this.requestTimeout) {
+                this.pendingRequests.delete(id);
+                request.reject(new Error('Request timeout'));
+            }
+        }
+    }
+}
+//# sourceMappingURL=bridge-service.js.map

package/dist/bridge-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-service.js","sourceRoot":"","sources":["../src/bridge-service.ts"],"names":[],"mappings":"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"}

package/dist/http-server.d.ts

@@ -0,0 +1,4 @@
+import { RobloxStudioTools } from './tools/index.js';
+import { BridgeService } from './bridge-service.js';
+export declare function createHttpServer(tools: RobloxStudioTools, bridge: BridgeService): import("express-serve-static-core").Express;
+//# sourceMappingURL=http-server.d.ts.map

package/dist/http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,aAAa,+CA2K/E"}

package/dist/http-server.js

@@ -0,0 +1,170 @@
+import express from 'express';
+import cors from 'cors';
+export function createHttpServer(tools, bridge) {
+    const app = express();
+    app.use(cors());
+    app.use(express.json());
+    // Health check endpoint
+    app.get('/health', (req, res) => {
+        res.json({ status: 'ok', service: 'robloxstudio-mcp' });
+    });
+    // Polling endpoint for Studio plugin
+    app.get('/poll', (req, res) => {
+        const pendingRequest = bridge.getPendingRequest();
+        if (pendingRequest) {
+            res.json({ request: pendingRequest.request, requestId: pendingRequest.requestId });
+        }
+        else {
+            res.json({ request: null });
+        }
+    });
+    // Response endpoint for Studio plugin
+    app.post('/response', (req, res) => {
+        const { requestId, response, error } = req.body;
+        if (error) {
+            bridge.rejectRequest(requestId, error);
+        }
+        else {
+            bridge.resolveRequest(requestId, response);
+        }
+        res.json({ success: true });
+    });
+    // MCP tool proxy endpoints - these will be called by AI tools
+    app.post('/mcp/get_file_tree', async (req, res) => {
+        try {
+            const result = await tools.getFileTree(req.body.path);
+            res.json(result);
+        }
+        catch (error) {
+            res.status(500).json({ error: error instanceof Error ? error.message : 'Unknown error' });
+        }
+    });
+    app.post('/mcp/get_file_content', async (req, res) => {
+        try {
+            const result = await tools.getFileContent(req.body.path);
+            res.json(result);
+        }
+        catch (error) {
+            res.status(500).json({ error: error instanceof Error ? error.message : 'Unknown error' });
+        }
+    });
+    app.post('/mcp/search_files', async (req, res) => {
+        try {
+            const result = await tools.searchFiles(req.body.query, req.body.searchType);
+            res.json(result);
+        }
+        catch (error) {
+            res.status(500).json({ error: error instanceof Error ? error.message : 'Unknown error' });
+        }
+    });
+    app.post('/mcp/get_file_properties', async (req, res) => {
+        try {
+            const result = await tools.getFileProperties(req.body.path);
+            res.json(result);
+        }
+        catch (error) {
+            res.status(500).json({ error: error instanceof Error ? error.message : 'Unknown error' });
+        }
+    });
+    app.post('/mcp/get_place_info', async (req, res) => {
+        try {
+            const result = await tools.getPlaceInfo();
+            res.json(result);
+        }
+        catch (error) {
+            res.status(500).json({ error: error instanceof Error ? error.message : 'Unknown error' });
+        }
+    });
+    app.post('/mcp/get_services', async (req, res) => {
+        try {
+            const result = await tools.getServices(req.body.serviceName);
+            res.json(result);
+        }
+        catch (error) {
+            res.status(500).json({ error: error instanceof Error ? error.message : 'Unknown error' });
+        }
+    });
+    app.post('/mcp/get_selection', async (req, res) => {
+        try {
+            const result = await tools.getSelection();
+            res.json(result);
+        }
+        catch (error) {
+            res.status(500).json({ error: error instanceof Error ? error.message : 'Unknown error' });
+        }
+    });
+    app.post('/mcp/search_objects', async (req, res) => {
+        try {
+            const result = await tools.searchObjects(req.body.query, req.body.searchType, req.body.propertyName);
+            res.json(result);
+        }
+        catch (error) {
+            res.status(500).json({ error: error instanceof Error ? error.message : 'Unknown error' });
+        }
+    });
+    app.post('/mcp/get_instance_properties', async (req, res) => {
+        try {
+            const result = await tools.getInstanceProperties(req.body.instancePath);
+            res.json(result);
+        }
+        catch (error) {
+            res.status(500).json({ error: error instanceof Error ? error.message : 'Unknown error' });
+        }
+    });
+    app.post('/mcp/get_instance_children', async (req, res) => {
+        try {
+            const result = await tools.getInstanceChildren(req.body.instancePath);
+            res.json(result);
+        }
+        catch (error) {
+            res.status(500).json({ error: error instanceof Error ? error.message : 'Unknown error' });
+        }
+    });
+    app.post('/mcp/search_by_property', async (req, res) => {
+        try {
+            const result = await tools.searchByProperty(req.body.propertyName, req.body.propertyValue);
+            res.json(result);
+        }
+        catch (error) {
+            res.status(500).json({ error: error instanceof Error ? error.message : 'Unknown error' });
+        }
+    });
+    app.post('/mcp/get_class_info', async (req, res) => {
+        try {
+            const result = await tools.getClassInfo(req.body.className);
+            res.json(result);
+        }
+        catch (error) {
+            res.status(500).json({ error: error instanceof Error ? error.message : 'Unknown error' });
+        }
+    });
+    app.post('/mcp/get_project_structure', async (req, res) => {
+        try {
+            const result = await tools.getProjectStructure();
+            res.json(result);
+        }
+        catch (error) {
+            res.status(500).json({ error: error instanceof Error ? error.message : 'Unknown error' });
+        }
+    });
+    app.post('/mcp/get_dependencies', async (req, res) => {
+        try {
+            const result = await tools.getDependencies(req.body.modulePath);
+            res.json(result);
+        }
+        catch (error) {
+            res.status(500).json({ error: error instanceof Error ? error.message : 'Unknown error' });
+        }
+    });
+    app.post('/mcp/validate_references', async (req, res) => {
+        try {
+            const result = await tools.validateReferences();
+            res.json(result);
+        }
+        catch (error) {
+            res.status(500).json({ error: error instanceof Error ? error.message : 'Unknown error' });
+        }
+    });
+    return app;
+}
+//# sourceMappingURL=http-server.js.map

package/dist/http-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.js","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * Roblox Studio MCP Server
+ *
+ * This server provides Model Context Protocol (MCP) tools for interacting with Roblox Studio.
+ * It allows AI assistants to access Studio data, scripts, and objects through a bridge plugin.
+ *
+ * Usage:
+ *   npx robloxstudio-mcp
+ *
+ * Or add to your MCP configuration:
+ *   "robloxstudio": {
+ *     "command": "npx",
+ *     "args": ["-y", "robloxstudio-mcp"]
+ *   }
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;GAcG"}