rbxstudio-mcp 1.9.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,319 @@
+# Roblox Studio MCP Server
+
+MCP server for AI-powered Roblox Studio integration. 22 specialized tools for exploring projects, analyzing scripts, and performing bulk operations.
+
+https://devforum.roblox.com/t/v180-roblox-studio-mcp-speed-up-your-workflow-by-letting-ai-read-paths-and-properties/3707071
+
+<a href="https://glama.ai/mcp/servers/@boshyxd/robloxstudio-mcp">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/@boshyxd/robloxstudio-mcp/badge" alt="Roblox Studio Server MCP server" />
+</a>
+
+## Quick Start
+
+**For Claude Code users:**
+```bash
+claude mcp add robloxstudio -- npx -y robloxstudio-mcp
+```
+
+**For other MCP clients (Claude Desktop, etc.):**
+```json
+{
+  "mcpServers": {
+    "robloxstudio-mcp": {
+      "command": "npx",
+      "args": ["-y", "robloxstudio-mcp"],
+      "description": "Advanced Roblox Studio integration for AI assistants"
+    }
+  }
+}
+```
+
+**Install NPM Package**
+```bash
+npm i robloxstudio-mcp
+```
+
+<details>
+<summary>Note for native Windows users</summary>
+If you encounter issues, you may need to run it through `cmd`. Update your configuration like this:
+
+```json
+{
+  "mcpServers": {
+    "robloxstudio-mcp": {
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "robloxstudio-mcp@latest"]
+    }
+  }
+}
+```
+</details>
+
+## Studio Plugin Setup (Required)
+
+The MCP server requires a companion Roblox Studio plugin:
+
+   - Download [MCPPlugin.rbxmx](https://github.com/boshyxd/robloxstudio-mcp/releases/latest/download/MCPPlugin.rbxmx)
+   - Save to your `%LOCALAPPDATA%/Roblox/Plugins` folder
+
+**After installation:**
+- Enable "Allow HTTP Requests" in Game Settings > Security
+- Click the "MCP Server" button in the Plugins toolbar
+- Status should show "Connected" when working
+
+## Architecture Overview
+
+Dual-component system bridging Roblox Studio with AI assistants:
+
+```mermaid
+%%{init: {'theme':'dark', 'themeVariables': {'primaryColor':'#2d3748', 'primaryTextColor':'#ffffff', 'primaryBorderColor':'#4a5568', 'lineColor':'#718096', 'sectionBkgColor':'#1a202c', 'altSectionBkgColor':'#2d3748', 'gridColor':'#4a5568', 'secondaryColor':'#2b6cb0', 'tertiaryColor':'#319795'}}}%%
+graph TB
+    subgraph AI_ENV ["AI Environment"]
+        AI["AI Assistant<br/>Claude Code/Desktop"]
+        MCP["MCP Server<br/>Node.js + TypeScript"]
+    end
+    
+    subgraph COMM_LAYER ["Communication Layer"]
+        HTTP["HTTP Bridge<br/>localhost:3002"]
+        QUEUE["Request Queue<br/>UUID tracking"]
+    end
+    
+    subgraph STUDIO_ENV ["Roblox Studio Environment"]
+        PLUGIN["Studio Plugin<br/>Luau Script"]
+        STUDIO["Roblox Studio<br/>APIs & Data"]
+    end
+    
+    subgraph TOOLS ["22 AI Tools"]
+        FILE["File System<br/>Trees, Search"]
+        CONTEXT["Studio Context<br/>Services, Objects"]
+        PROPS["Properties<br/>Get, Set, Mass Ops"]
+        CREATE["Object Creation<br/>Single, Mass, Properties"]
+        PROJECT["Project Analysis<br/>Smart Structure"]
+        OUTPUT["Output Capture<br/>Logs, Errors"]
+        INSTMANIP["Instance Ops<br/>Clone, Move"]
+        VALIDATE["Script Validation<br/>Syntax Check"]
+    end
+    
+    AI -->|stdio| MCP
+    MCP -->|HTTP POST| HTTP
+    HTTP -->|Queue Request| QUEUE
+    PLUGIN -->|Poll every 500ms| HTTP
+    HTTP -->|Pending Work| PLUGIN
+    PLUGIN -->|Execute APIs| STUDIO
+    STUDIO -->|Return Data| PLUGIN
+    PLUGIN -->|HTTP Response| HTTP
+    HTTP -->|Resolve Promise| MCP
+    MCP -->|Tool Result| AI
+    
+    MCP -.->|Exposes| FILE
+    MCP -.->|Exposes| CONTEXT
+    MCP -.->|Exposes| PROPS
+    MCP -.->|Exposes| CREATE
+    MCP -.->|Exposes| PROJECT
+    MCP -.->|Exposes| OUTPUT
+    MCP -.->|Exposes| INSTMANIP
+    MCP -.->|Exposes| VALIDATE
+    
+    classDef aiStyle fill:#1e40af,stroke:#3b82f6,stroke-width:2px,color:#ffffff
+    classDef mcpStyle fill:#7c3aed,stroke:#8b5cf6,stroke-width:2px,color:#ffffff
+    classDef httpStyle fill:#ea580c,stroke:#f97316,stroke-width:2px,color:#ffffff
+    classDef pluginStyle fill:#059669,stroke:#10b981,stroke-width:2px,color:#ffffff
+    classDef studioStyle fill:#dc2626,stroke:#ef4444,stroke-width:2px,color:#ffffff
+    classDef toolStyle fill:#0891b2,stroke:#06b6d4,stroke-width:2px,color:#ffffff
+    
+    class AI aiStyle
+    class MCP mcpStyle
+    class HTTP,QUEUE httpStyle
+    class PLUGIN pluginStyle
+    class STUDIO studioStyle
+    class FILE,CONTEXT,PROPS,CREATE,PROJECT,OUTPUT,INSTMANIP,VALIDATE toolStyle
+```
+
+### Key Components:
+- MCP Server (Node.js/TypeScript) - Exposes 22 tools via stdio
+- HTTP Bridge - Request/response queue on localhost:3002
+- Studio Plugin (Luau) - Polls server and executes API calls
+- Smart Caching - Efficient data transfer
+
+## 22 AI Tools
+
+### File System Tools
+- `get_file_tree` - Complete project hierarchy with scripts, models, folders
+- `search_files` - Find files by name, type, or content patterns  
+
+### Studio Context Tools  
+- `get_place_info` - Place ID, name, game settings, workspace info
+- `get_services` - All Roblox services and their child counts
+- `search_objects` - Find instances by name, class, or properties
+
+### Instance & Property Tools
+- `get_instance_properties` - Complete property dump for any object
+- `get_instance_children` - Child objects with metadata
+- `search_by_property` - Find objects with specific property values
+- `get_class_info` - Available properties/methods for Roblox classes
+
+### Property Modification Tools 
+- `set_property` - Set a property on any Roblox instance
+- `mass_set_property` - Set the same property on multiple instances
+- `mass_get_property` - Get the same property from multiple instances
+
+### Object Creation Tools
+- `create_object` - Create a new Roblox object instance
+- `create_object_with_properties` - Create objects with initial properties
+- `mass_create_objects` - Create multiple objects at once
+- `mass_create_objects_with_properties` - Create multiple objects with properties
+- `delete_object` - Delete a Roblox object instance
+
+### Project Analysis Tools
+- `get_project_structure` - Smart hierarchy with depth control (recommended: 5-10)
+
+### Output Capture Tool (NEW in v1.9.0)
+- `get_output` - Read Output window content (print, warn, error messages)
+
+### Instance Manipulation Tools (NEW in v1.9.0)
+- `clone_instance` - Clone/copy an instance to a new parent (deep copy)
+- `move_instance` - Move an instance to a new parent location
+
+### Script Validation Tool (NEW in v1.9.0)
+- `validate_script` - Validate Lua/Luau syntax without running, includes deprecation warnings
+
+> Note: Previous tools removed: `get_file_content`, `get_file_properties`, `get_selection`, `get_dependencies`, `validate_references`. Use Rojo/Argon workflows instead.
+
+## AI-Optimized Features
+
+### Mass Operations (v1.3.0)
+- Bulk property editing
+- Mass object creation
+- Batch property reading
+- Atomic undo/redo operations
+
+```typescript
+// Example: Set multiple parts to red
+mass_set_property(["game.Workspace.Part1", "game.Workspace.Part2"], "BrickColor", "Really red")
+```
+
+### Smart Project Structure
+- Service overview with child counts
+- Path-based exploration: `get_project_structure("game.ServerStorage", maxDepth=5)`
+- Script-only filtering for code analysis
+- Intelligent grouping for large folders
+- Recommended maxDepth=5-10
+
+### Rich Metadata
+- Script status tracking
+- GUI intelligence
+- Performance optimized
+
+## Development & Testing
+
+### Commands
+```bash
+npm run dev         # Development server with hot reload  
+npm run build       # Production build
+npm start           # Run built server
+npm run lint        # ESLint code quality
+npm run typecheck   # TypeScript validation
+```
+
+### Plugin Development
+- Live reload
+- Robust error handling
+- Debug logging
+- Visual status indicators
+
+## Communication Protocol
+
+```mermaid
+%%{init: {'theme':'dark', 'themeVariables': {'primaryColor':'#2d3748', 'primaryTextColor':'#ffffff', 'primaryBorderColor':'#4a5568', 'lineColor':'#10b981', 'sectionBkgColor':'#1a202c', 'altSectionBkgColor':'#2d3748', 'gridColor':'#4a5568', 'secondaryColor':'#3b82f6', 'tertiaryColor':'#8b5cf6', 'background':'#1a202c', 'mainBkg':'#2d3748', 'secondBkg':'#374151', 'tertiaryColor':'#6366f1'}}}%%
+sequenceDiagram
+    participant AI as AI Assistant
+    participant MCP as MCP Server  
+    participant HTTP as HTTP Bridge
+    participant PLUGIN as Studio Plugin
+    participant STUDIO as Roblox Studio
+    
+    Note over AI,STUDIO: Tool Request Flow
+    
+    AI->>+MCP: Call tool (e.g., get_file_tree)
+    MCP->>+HTTP: Queue request with UUID
+    HTTP->>HTTP: Store in pending requests map
+    HTTP-->>-MCP: Request queued
+    
+    Note over PLUGIN: Polling every 500ms
+    PLUGIN->>+HTTP: GET /poll
+    HTTP->>-PLUGIN: Return pending request + UUID
+    
+    PLUGIN->>+STUDIO: Execute Studio APIs
+    Note over STUDIO: game.ServerStorage<br/>Selection:Get()<br/>Instance properties
+    STUDIO->>-PLUGIN: Return Studio data
+    
+    PLUGIN->>+HTTP: POST /response with UUID + data
+    HTTP->>-MCP: Resolve promise with data
+    MCP->>-AI: Return tool result
+    
+    Note over AI,STUDIO: Error Handling
+    
+    alt Request Timeout (30s)
+        HTTP->>MCP: Reject promise with timeout
+        MCP->>AI: Return error message
+    end
+    
+    alt Plugin Disconnected
+        PLUGIN->>HTTP: Connection lost
+        HTTP->>HTTP: Exponential backoff retry
+        Note over PLUGIN: Status: "Waiting for server..."
+    end
+```
+
+**Features:**
+- 30-second timeouts with exponential backoff
+- Automatic retries
+- Response limiting
+- Request deduplication
+
+## Example Usage
+
+```javascript
+// Get service overview
+get_project_structure()
+
+// Explore weapons folder
+get_project_structure("game.ServerStorage.Weapons", maxDepth=2)
+
+// Find all Sound objects
+search_by_property("ClassName", "Sound")
+
+// Get UI component details
+get_instance_properties("game.StarterGui.MainMenu.SettingsFrame")
+
+// === NEW in v1.9.0 ===
+
+// Clone an object to a different location
+clone_instance("game.Workspace.walkietalkie", "game.ReplicatedStorage")
+
+// Move a tool to StarterPack
+move_instance("game.Workspace.Sword", "game.StarterPack")
+
+// Validate a script before running
+validate_script("game.ServerScriptService.MainScript")
+
+// Monitor game output after testing
+get_output({ limit: 50, messageTypes: ["MessageError", "MessageWarning"] })
+```
+
+## Configuration
+
+**Environment Variables:**
+- `MCP_SERVER_PORT` - MCP server port (default: stdio)
+- `HTTP_SERVER_PORT` - HTTP bridge port (default: 3002)
+- `PLUGIN_POLL_INTERVAL` - Plugin poll frequency (default: 500ms)
+- `REQUEST_TIMEOUT` - Request timeout (default: 30000ms)
+
+**Studio Settings:**
+- **Allow HTTP Requests** (Game Settings > Security)
+- **HttpService.HttpEnabled = true**
+- **Plugin activated** via toolbar button
+
+## License
+
+MIT License - Feel free to use in commercial and personal projects!

package/dist/__tests__/bridge-service.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bridge-service.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-service.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/bridge-service.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/bridge-service.test.js

@@ -0,0 +1,109 @@
+import { BridgeService } from '../bridge-service';
+describe('BridgeService', () => {
+    let bridgeService;
+    beforeEach(() => {
+        bridgeService = new BridgeService();
+        jest.useFakeTimers();
+    });
+    afterEach(() => {
+        jest.useRealTimers();
+    });
+    describe('Request Management', () => {
+        test('should create and store a pending request', async () => {
+            const endpoint = '/api/test';
+            const data = { test: 'data' };
+            const requestPromise = bridgeService.sendRequest(endpoint, data);
+            // Check that request is pending
+            const pendingRequest = bridgeService.getPendingRequest();
+            expect(pendingRequest).toBeTruthy();
+            expect(pendingRequest?.request.endpoint).toBe(endpoint);
+            expect(pendingRequest?.request.data).toEqual(data);
+        });
+        test('should resolve request when response is received', async () => {
+            const endpoint = '/api/test';
+            const data = { test: 'data' };
+            const response = { result: 'success' };
+            const requestPromise = bridgeService.sendRequest(endpoint, data);
+            const pendingRequest = bridgeService.getPendingRequest();
+            // Resolve the request
+            bridgeService.resolveRequest(pendingRequest.requestId, response);
+            const result = await requestPromise;
+            expect(result).toEqual(response);
+        });
+        test('should reject request on error', async () => {
+            const endpoint = '/api/test';
+            const data = { test: 'data' };
+            const error = 'Test error';
+            const requestPromise = bridgeService.sendRequest(endpoint, data);
+            const pendingRequest = bridgeService.getPendingRequest();
+            // Reject the request
+            bridgeService.rejectRequest(pendingRequest.requestId, error);
+            await expect(requestPromise).rejects.toEqual(error);
+        });
+        test('should timeout request after 30 seconds', async () => {
+            const endpoint = '/api/test';
+            const data = { test: 'data' };
+            const requestPromise = bridgeService.sendRequest(endpoint, data);
+            // Fast-forward time by 31 seconds
+            jest.advanceTimersByTime(31000);
+            await expect(requestPromise).rejects.toThrow('Request timeout');
+        });
+    });
+    describe('Cleanup Operations', () => {
+        test('should clean up old requests', async () => {
+            // Create multiple requests
+            const promises = [
+                bridgeService.sendRequest('/api/test1', {}),
+                bridgeService.sendRequest('/api/test2', {}),
+                bridgeService.sendRequest('/api/test3', {})
+            ];
+            // Fast-forward time by 31 seconds
+            jest.advanceTimersByTime(31000);
+            // Clean up old requests
+            bridgeService.cleanupOldRequests();
+            // All requests should be rejected
+            for (const promise of promises) {
+                await expect(promise).rejects.toThrow('Request timeout');
+            }
+            // No pending requests should remain
+            expect(bridgeService.getPendingRequest()).toBeNull();
+        });
+        test('should clear all pending requests on disconnect', async () => {
+            // Create multiple requests
+            const promises = [
+                bridgeService.sendRequest('/api/test1', {}),
+                bridgeService.sendRequest('/api/test2', {}),
+                bridgeService.sendRequest('/api/test3', {})
+            ];
+            // Clear all requests
+            bridgeService.clearAllPendingRequests();
+            // All requests should be rejected with connection closed error
+            for (const promise of promises) {
+                await expect(promise).rejects.toThrow('Connection closed');
+            }
+            // No pending requests should remain
+            expect(bridgeService.getPendingRequest()).toBeNull();
+        });
+    });
+    describe('Request Priority', () => {
+        test('should return oldest request first', async () => {
+            // Create requests with small delays
+            bridgeService.sendRequest('/api/test1', { order: 1 });
+            // Small delay to ensure different timestamps
+            await new Promise(resolve => setTimeout(resolve, 10));
+            bridgeService.sendRequest('/api/test2', { order: 2 });
+            await new Promise(resolve => setTimeout(resolve, 10));
+            bridgeService.sendRequest('/api/test3', { order: 3 });
+            // Should get the first (oldest) request
+            const firstRequest = bridgeService.getPendingRequest();
+            expect(firstRequest?.request.data.order).toBe(1);
+            // Should get the second request next
+            const secondRequest = bridgeService.getPendingRequest();
+            expect(secondRequest?.request.data.order).toBe(2);
+            // Should get the third request last
+            const thirdRequest = bridgeService.getPendingRequest();
+            expect(thirdRequest?.request.data.order).toBe(3);
+        });
+    });
+});
+//# sourceMappingURL=bridge-service.test.js.map

package/dist/__tests__/bridge-service.test.js.map

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

package/dist/__tests__/http-server.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=http-server.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/http-server.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/http-server.test.js

@@ -0,0 +1,193 @@
+import request from 'supertest';
+import { createHttpServer } from '../http-server';
+import { RobloxStudioTools } from '../tools/index';
+import { BridgeService } from '../bridge-service';
+describe('HTTP Server', () => {
+    let app;
+    let bridge;
+    let tools;
+    beforeEach(() => {
+        bridge = new BridgeService();
+        tools = new RobloxStudioTools(bridge);
+        app = createHttpServer(tools, bridge);
+    });
+    describe('Health Check', () => {
+        test('should return health status', async () => {
+            const response = await request(app)
+                .get('/health')
+                .expect(200);
+            expect(response.body).toMatchObject({
+                status: 'ok',
+                service: 'robloxstudio-mcp',
+                pluginConnected: false,
+                mcpServerActive: false
+            });
+        });
+    });
+    describe('Plugin Connection Management', () => {
+        test('should handle plugin ready notification', async () => {
+            const response = await request(app)
+                .post('/ready')
+                .expect(200);
+            expect(response.body).toEqual({ success: true });
+            expect(app.isPluginConnected()).toBe(true);
+        });
+        test('should handle plugin disconnect', async () => {
+            // First connect
+            await request(app).post('/ready').expect(200);
+            expect(app.isPluginConnected()).toBe(true);
+            // Then disconnect
+            const response = await request(app)
+                .post('/disconnect')
+                .expect(200);
+            expect(response.body).toEqual({ success: true });
+            expect(app.isPluginConnected()).toBe(false);
+        });
+        test('should clear pending requests on disconnect', async () => {
+            // Add some pending requests
+            bridge.sendRequest('/api/test1', {});
+            bridge.sendRequest('/api/test2', {});
+            expect(bridge.getPendingRequest()).toBeTruthy();
+            // Disconnect
+            await request(app).post('/disconnect').expect(200);
+            // All requests should be cleared
+            expect(bridge.getPendingRequest()).toBeNull();
+        });
+        test('should timeout plugin connection after inactivity', async () => {
+            // Connect plugin
+            await request(app).post('/ready').expect(200);
+            expect(app.isPluginConnected()).toBe(true);
+            // Simulate time passing (11 seconds of inactivity)
+            const originalDateNow = Date.now;
+            Date.now = jest.fn(() => originalDateNow() + 11000);
+            // Plugin should be considered disconnected
+            expect(app.isPluginConnected()).toBe(false);
+            // Restore Date.now
+            Date.now = originalDateNow;
+        });
+    });
+    describe('Polling Endpoint', () => {
+        test('should return 503 when MCP server is not active', async () => {
+            const response = await request(app)
+                .get('/poll')
+                .expect(503);
+            expect(response.body).toMatchObject({
+                error: 'MCP server not connected',
+                pluginConnected: true,
+                mcpConnected: false,
+                request: null
+            });
+        });
+        test('should return pending request when MCP is active', async () => {
+            // Activate MCP server
+            app.setMCPServerActive(true);
+            // Add a pending request
+            bridge.sendRequest('/api/test', { data: 'test' });
+            const response = await request(app)
+                .get('/poll')
+                .expect(200);
+            expect(response.body).toMatchObject({
+                request: {
+                    endpoint: '/api/test',
+                    data: { data: 'test' }
+                },
+                mcpConnected: true,
+                pluginConnected: true
+            });
+            expect(response.body.requestId).toBeTruthy();
+        });
+        test('should return null request when no pending requests', async () => {
+            // Activate MCP server
+            app.setMCPServerActive(true);
+            const response = await request(app)
+                .get('/poll')
+                .expect(200);
+            expect(response.body).toMatchObject({
+                request: null,
+                mcpConnected: true,
+                pluginConnected: true
+            });
+        });
+        test('should mark plugin as connected when polling', async () => {
+            expect(app.isPluginConnected()).toBe(false);
+            await request(app).get('/poll').expect(503);
+            expect(app.isPluginConnected()).toBe(true);
+        });
+    });
+    describe('Response Handling', () => {
+        test('should handle successful response', async () => {
+            const requestId = 'test-request-id';
+            const responseData = { result: 'success' };
+            // Create a pending request
+            const requestPromise = bridge.sendRequest('/api/test', {});
+            const pendingRequest = bridge.getPendingRequest();
+            // Send response
+            const response = await request(app)
+                .post('/response')
+                .send({
+                requestId: pendingRequest.requestId,
+                response: responseData
+            })
+                .expect(200);
+            expect(response.body).toEqual({ success: true });
+            // Check that the request was resolved
+            const result = await requestPromise;
+            expect(result).toEqual(responseData);
+        });
+        test('should handle error response', async () => {
+            const error = 'Test error message';
+            // Create a pending request
+            const requestPromise = bridge.sendRequest('/api/test', {});
+            const pendingRequest = bridge.getPendingRequest();
+            // Send error response
+            const response = await request(app)
+                .post('/response')
+                .send({
+                requestId: pendingRequest.requestId,
+                error: error
+            })
+                .expect(200);
+            expect(response.body).toEqual({ success: true });
+            // Check that the request was rejected
+            await expect(requestPromise).rejects.toEqual(error);
+        });
+    });
+    describe('MCP Server State Management', () => {
+        test('should track MCP server activity', async () => {
+            app.setMCPServerActive(true);
+            expect(app.isMCPServerActive()).toBe(true);
+            // Simulate activity
+            app.trackMCPActivity();
+            // Should still be active
+            expect(app.isMCPServerActive()).toBe(true);
+        });
+        test('should timeout MCP server after inactivity', async () => {
+            app.setMCPServerActive(true);
+            expect(app.isMCPServerActive()).toBe(true);
+            // Simulate time passing (16 seconds of inactivity)
+            const originalDateNow = Date.now;
+            Date.now = jest.fn(() => originalDateNow() + 16000);
+            // MCP server should be considered inactive
+            expect(app.isMCPServerActive()).toBe(false);
+            // Restore Date.now
+            Date.now = originalDateNow;
+        });
+    });
+    describe('Status Endpoint', () => {
+        test('should return current status', async () => {
+            // Set up some state
+            await request(app).post('/ready').expect(200);
+            app.setMCPServerActive(true);
+            const response = await request(app)
+                .get('/status')
+                .expect(200);
+            expect(response.body).toMatchObject({
+                pluginConnected: true,
+                mcpServerActive: true
+            });
+            expect(response.body.lastMCPActivity).toBeGreaterThan(0);
+            expect(response.body.uptime).toBeGreaterThan(0);
+        });
+    });
+});
+//# sourceMappingURL=http-server.test.js.map