threlte-mcp 1.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Raul Contreras
+
+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,306 @@
+# Threlte MCP
+
+[![npm version](https://img.shields.io/npm/v/threlte-mcp.svg)](https://www.npmjs.com/package/threlte-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-blue.svg)](https://modelcontextprotocol.io/)
+
+An MCP (Model Context Protocol) server that enables AI agents to inspect and manipulate Three.js/Threlte scenes in real-time.
+
+## ✅ Compatible With
+
+- **Claude Desktop** - Anthropic's desktop app
+- **Antigravity** - Google's AI IDE
+- **Claude Code** - CLI tool for Claude
+- **Cursor** - AI-powered code editor
+- **Windsurf** - Codeium's AI IDE
+- **Continue** - VS Code AI extension
+- **Any MCP-compatible client**
+
+[See detailed compatibility guide →](./COMPATIBILITY.md)
+
+## Features
+
+- 🔍 **Scene Inspection** - View the full 3D scene hierarchy, find objects by name/type
+- 🎯 **Object Manipulation** - Move, rotate, scale, show/hide objects
+- 🎨 **Materials & Assets** - Apply materials, load GLTF models, change environment
+- 🧪 **Asset Analysis** - Inspect GLTF structure and validate performance
+- dYZ+ **Asset Optimization** - Simplify meshes, compress textures, prune unused data
+- dY"? **Svelte Export** - Generate Threlte/Svelte components from GLTF
+- dYZ? **Camera Presets** - Save, load, and animate camera views
+- ⚡ **Physics Control** - Add physics bodies, apply impulses, set gravity
+- 🎭 **Vibe Presets** - Apply mood presets (cozy, spooky, neon, etc.)
+
+## Installation
+
+```bash
+npm install threlte-mcp
+```
+
+## Quick Start
+
+### 1. Install the package
+
+```bash
+npm install threlte-mcp
+```
+
+### 2. Configure your IDE (one-time setup)
+
+```bash
+npx threlte-mcp setup
+```
+
+This auto-detects your IDE (Antigravity, Cursor, Claude Desktop) and creates the MCP config.
+
+### 3. Add the component to your Threlte app
+
+Requires Svelte 5 for the MCPBridge component.
+
+```svelte
+<script>
+  import { MCPBridgeComponent } from 'threlte-mcp/client';
+</script>
+
+<!-- Add inside your <Canvas> -->
+<MCPBridgeComponent />
+```
+
+**That's it!** The AI can now inspect and manipulate your scene.
+
+---
+
+<details>
+<summary>📋 Manual Configuration (Alternative)</summary>
+
+If `npx threlte-mcp setup` doesn't work for your IDE, manually add to your config:
+
+```json
+{
+  "mcpServers": {
+    "threlte-mcp": {
+      "command": "npx",
+      "args": ["-y", "threlte-mcp"]
+    }
+  }
+}
+```
+
+Config file locations:
+- **Antigravity**: `~/.gemini/antigravity/mcp_config.json`
+- **Cursor**: `~/.cursor/mcp.json`
+- **Claude Desktop**: `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac)
+
+</details>
+
+<details>
+<summary>🔧 Advanced: TypeScript API</summary>
+
+```typescript
+import { MCPBridge } from 'threlte-mcp/client';
+import { useThrelte } from '@threlte/core';
+
+const { scene } = useThrelte();
+
+// Create bridge (auto-connects in dev mode)
+const bridge = new MCPBridge(scene, {
+  url: 'ws://127.0.0.1:8082',  // default
+  autoConnect: true,           // default in dev
+  reconnectDelay: 60000,       // 1 minute
+});
+
+// In render loop
+bridge.update();
+
+// Get scene state
+bridge.getSceneState();
+
+// Find objects
+bridge.findObjects({ nameContains: 'player' });
+```
+
+</details>
+
+
+**Option B: Per-Scene (Simple for prototyping)**
+
+```svelte
+<script lang="ts">
+  import { onMount, onDestroy } from 'svelte';
+  import { useThrelte } from '@threlte/core';
+
+  const { scene } = useThrelte();
+  let ws: WebSocket | null = null;
+  
+  onMount(() => {
+    ws = new WebSocket('ws://localhost:8082');
+    
+    ws.onopen = () => {
+      console.log('[MCPBridge] Connected');
+      // Send initial scene state
+      ws?.send(JSON.stringify({
+        type: 'sceneState',
+        data: serializeScene(scene)
+      }));
+    };
+    
+    ws.onmessage = (event) => {
+      const command = JSON.parse(event.data);
+      handleCommand(command);
+    };
+  });
+  
+  onDestroy(() => {
+    ws?.close();
+  });
+  
+  function serializeScene(obj: THREE.Object3D, depth = 0, maxDepth = 3) {
+    if (depth > maxDepth) return null;
+    return {
+      name: obj.name,
+      type: obj.type,
+      position: obj.position.toArray(),
+      rotation: obj.rotation.toArray().slice(0, 3),
+      scale: obj.scale.toArray(),
+      visible: obj.visible,
+      children: obj.children.map(c => serializeScene(c, depth + 1, maxDepth)).filter(Boolean)
+    };
+  }
+  
+  function handleCommand(cmd: any) {
+    const { action, requestId, ...params } = cmd;
+    let result;
+    
+    switch (action) {
+      case 'getFullSceneState':
+        result = { data: serializeScene(scene, 0, params.maxDepth || 3) };
+        break;
+      case 'moveSceneObject':
+        const obj = scene.getObjectByName(params.name || params.path);
+        if (obj && params.position) {
+          obj.position.set(...params.position);
+          result = { success: true };
+        }
+        break;
+      // Add more handlers as needed
+    }
+    
+    if (requestId) {
+      ws?.send(JSON.stringify({ ...result, requestId }));
+    }
+  }
+</script>
+```
+
+### 3. Run your app and start using MCP tools
+
+Once both the MCP server and your Threlte app are running, AI agents can:
+
+```
+"Get the scene state"
+"Find all objects named 'Player'"  
+"Move the 'Camera' to position [0, 5, 10]"
+"Apply the 'neon' vibe to the scene"
+```
+
+## Available Tools
+
+### Scene Inspection
+| Tool | Description |
+|------|-------------|
+| `get_scene_state` | Get full scene hierarchy |
+| `find_objects` | Search by name, type, or userData |
+| `get_object_position` | Get position of specific object |
+| `log_positions` | Export positions for code |
+
+### Camera
+| Tool | Description |
+|------|-------------|
+| `set_camera_position` | Set camera position, lookAt, and lens settings |
+| `save_camera_preset` | Save current camera view as a preset |
+| `load_camera_preset` | Load a saved camera view |
+| `list_camera_presets` | List all saved camera presets |
+| `delete_camera_preset` | Delete a saved camera preset |
+| `animate_camera_presets` | Animate through a sequence of presets |
+
+### Hierarchy Management
+| Tool | Description |
+|------|-------------|
+| `spawn_entity` | Create primitive (box, sphere, etc.) |
+| `destroy_entity` | Remove object from scene |
+| `move_object` | Set object position |
+| `set_transform` | Set position, rotation, scale |
+| `set_visibility` | Show/hide object |
+| `rename_entity` | Rename object |
+| `duplicate_entity` | Clone object |
+
+### Physics
+| Tool | Description |
+|------|-------------|
+| `make_physical` | Add physics body |
+| `remove_physics` | Remove physics body |
+| `apply_impulse` | Apply force |
+| `set_gravity` | Set global gravity |
+
+### Asset Processing
+| Tool | Description |
+|------|-------------|
+| `analyze_gltf` | Inspect GLTF/GLB structure |
+| `validate_asset` | Validate GLTF/GLB for issues |
+| `optimize_gltf` | Optimize GLTF/GLB assets |
+| `export_to_svelte` | Generate Threlte/Svelte component |
+
+### Materials & Assets
+| Tool | Description |
+|------|-------------|
+| `load_asset` | Load GLTF/GLB model |
+| `apply_material` | Set material |
+| `set_environment` | Set skybox/environment |
+
+### Atmosphere
+| Tool | Description |
+|------|-------------|
+| `apply_vibe` | Apply mood preset |
+| `get_bridge_status` | Check connection status |
+
+## Configuration
+
+### WebSocket Connection
+
+The server uses port 8082 by default for WebSocket communication.
+
+### Environment Variables
+
+The MCPBridge auto-connects in development mode. For production, you can enable it via environment variable:
+
+```bash
+# Add to .env file:
+VITE_MCP_ENABLED=true
+```
+
+This is useful for:
+- Testing in production builds
+- Demo environments
+- Debugging production issues
+
+**Note:** Auto-enabled in development mode (`npm run dev`), no configuration needed.
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/RaulContreras123/threlte-mcp.git
+cd threlte-mcp
+
+# Install dependencies
+npm install
+
+# Run in development
+npm run dev
+
+# Build for production
+npm run build
+```
+
+## License
+
+MIT © Raul Contreras

package/dist/bridge-server.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Threlte MCP - WebSocket Bridge Server
+ *
+ * Provides a WebSocket server that game clients connect to for real-time
+ * scene inspection and manipulation by AI agents.
+ */
+export interface MCPCommand {
+    action: string;
+    requestId?: string;
+    maxDepth?: number;
+    name?: string;
+    path?: string;
+    position?: number[];
+    rotation?: number[];
+    scale?: number[];
+    lookAt?: number[];
+    fov?: number;
+    near?: number;
+    far?: number;
+    filter?: {
+        nameContains?: string;
+        type?: string;
+        hasUserData?: string;
+    };
+    id?: string;
+    type?: string;
+    material?: {
+        color?: string;
+        metalness?: number;
+        roughness?: number;
+    };
+    parent?: string;
+    visible?: boolean;
+    newName?: string;
+    offset?: number[];
+    colliders?: string;
+    mass?: number;
+    friction?: number;
+    restitution?: number;
+    gravityScale?: number;
+    vector?: number[];
+    url?: string;
+    preset?: string;
+    prop?: string;
+    value?: string | number | boolean;
+    background?: string;
+    color?: string;
+    sheet?: string;
+    sequence?: string;
+    rate?: number;
+    range?: [number, number];
+    reverse?: boolean;
+    time?: number;
+    object?: string;
+    key?: string;
+    event?: string;
+    payload?: object;
+    questId?: string;
+    status?: string;
+    progress?: number;
+    category?: string;
+    vibe?: string;
+    targets?: string;
+    properties?: string[];
+    intensity?: number;
+    animate?: boolean;
+    duration?: number;
+}
+export interface BridgeServerOptions {
+    port?: number;
+    commandTimeout?: number;
+}
+export declare class BridgeServer {
+    private wss;
+    private client;
+    private pendingRequests;
+    private requestId;
+    private lastSceneState;
+    private listening;
+    private lastError;
+    private startupError;
+    private port;
+    private commandTimeout;
+    constructor(options?: BridgeServerOptions);
+    private startServer;
+    getStatus(): {
+        listening: boolean;
+        port: number;
+        connected: boolean;
+        startupError: string | null;
+        lastError: string | null;
+        pendingRequests: number;
+    };
+    isConnected(): boolean;
+    waitForConnection(timeoutMs?: number): Promise<void>;
+    connect(): Promise<void>;
+    private handleMessage;
+    sendCommand(command: MCPCommand): Promise<unknown>;
+    close(): void;
+}
+//# sourceMappingURL=bridge-server.d.ts.map

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

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

package/dist/bridge-server.js

@@ -0,0 +1,155 @@
+/**
+ * Threlte MCP - WebSocket Bridge Server
+ *
+ * Provides a WebSocket server that game clients connect to for real-time
+ * scene inspection and manipulation by AI agents.
+ */
+import { WebSocketServer, WebSocket } from 'ws';
+export class BridgeServer {
+    wss = null;
+    client = null;
+    pendingRequests = new Map();
+    requestId = 0;
+    lastSceneState = null;
+    listening = false;
+    lastError = null;
+    startupError = null;
+    port;
+    commandTimeout;
+    constructor(options = {}) {
+        this.port = options.port ?? 8083;
+        this.commandTimeout = options.commandTimeout ?? 5000;
+        this.startServer();
+    }
+    startServer() {
+        try {
+            console.error(`[BridgeServer] Starting WebSocket server on port ${this.port}...`);
+            this.wss = new WebSocketServer({ port: this.port });
+            this.wss.on('listening', () => {
+                console.error(`[BridgeServer] WebSocket server listening on port ${this.port}`);
+                this.listening = true;
+                this.startupError = null;
+            });
+            this.wss.on('connection', (ws) => {
+                console.error('[BridgeServer] Game client connected');
+                this.client = ws;
+                ws.on('message', (data) => {
+                    try {
+                        const message = JSON.parse(data.toString());
+                        this.handleMessage(message);
+                    }
+                    catch (error) {
+                        console.error('[BridgeServer] Failed to parse message:', error);
+                    }
+                });
+                ws.on('close', () => {
+                    console.error('[BridgeServer] Game client disconnected');
+                    this.client = null;
+                });
+                ws.on('error', (error) => {
+                    console.error('[BridgeServer] Client error:', error);
+                    this.lastError = error.message;
+                });
+            });
+            this.wss.on('error', (error) => {
+                console.error('[BridgeServer] Server error:', error);
+                this.startupError = error.message;
+                this.listening = false;
+            });
+        }
+        catch (error) {
+            console.error('[BridgeServer] Failed to start server:', error);
+            this.startupError = error.message;
+        }
+    }
+    getStatus() {
+        return {
+            listening: this.listening,
+            port: this.port,
+            connected: this.client !== null && this.client.readyState === WebSocket.OPEN,
+            startupError: this.startupError,
+            lastError: this.lastError,
+            pendingRequests: this.pendingRequests.size
+        };
+    }
+    isConnected() {
+        return this.client !== null && this.client.readyState === WebSocket.OPEN;
+    }
+    async waitForConnection(timeoutMs = 10000) {
+        if (this.isConnected())
+            return;
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                reject(new Error('Timeout waiting for game client to connect'));
+            }, timeoutMs);
+            const interval = setInterval(() => {
+                if (this.isConnected()) {
+                    clearTimeout(timeout);
+                    clearInterval(interval);
+                    resolve();
+                }
+            }, 100);
+        });
+    }
+    async connect() {
+        return this.waitForConnection();
+    }
+    handleMessage(message) {
+        if (typeof message === 'object' && message !== null && 'data' in message) {
+            this.lastSceneState = message;
+        }
+        if (typeof message === 'object' &&
+            message !== null &&
+            'requestId' in message) {
+            const { requestId, ...data } = message;
+            const pending = this.pendingRequests.get(requestId);
+            if (pending) {
+                clearTimeout(pending.timeout);
+                this.pendingRequests.delete(requestId);
+                pending.resolve(data);
+            }
+        }
+    }
+    async sendCommand(command) {
+        if (!this.isConnected()) {
+            throw new Error('No game client connected');
+        }
+        const requestId = `req_${++this.requestId}`;
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                this.pendingRequests.delete(requestId);
+                if (command.action === 'getFullSceneState' || command.action === 'findObjects') {
+                    resolve(this.lastSceneState);
+                }
+                else {
+                    reject(new Error('Command timeout'));
+                }
+            }, this.commandTimeout);
+            this.pendingRequests.set(requestId, { resolve, reject, timeout });
+            try {
+                this.client.send(JSON.stringify({
+                    ...command,
+                    requestId,
+                }));
+            }
+            catch (error) {
+                clearTimeout(timeout);
+                this.pendingRequests.delete(requestId);
+                reject(error);
+            }
+        });
+    }
+    close() {
+        if (this.wss) {
+            this.wss.close();
+            this.wss = null;
+        }
+        this.client = null;
+        this.pendingRequests.forEach((req) => {
+            clearTimeout(req.timeout);
+            req.reject(new Error('Server closed'));
+        });
+        this.pendingRequests.clear();
+    }
+}
+//# sourceMappingURL=bridge-server.js.map

package/dist/bridge-server.js.map

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

package/dist/camera-presets.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Camera Preset System
+ *
+ * Manages saving and loading camera positions for quick scene navigation
+ * Presets are stored in-memory and can optionally be persisted to localStorage
+ */
+export interface CameraPreset {
+    name: string;
+    position: [number, number, number];
+    lookAt?: [number, number, number];
+    fov?: number;
+    near?: number;
+    far?: number;
+    timestamp?: number;
+    description?: string;
+}
+export interface CameraPresetCollection {
+    presets: Record<string, CameraPreset>;
+    lastModified: number;
+}
+/**
+ * In-memory preset storage
+ * Will be synced with browser-side storage via WebSocket
+ */
+declare class CameraPresetManager {
+    private presets;
+    /**
+     * Save a camera preset
+     */
+    savePreset(preset: CameraPreset): void;
+    /**
+     * Load a camera preset by name
+     */
+    loadPreset(name: string): CameraPreset | undefined;
+    /**
+     * List all available presets
+     */
+    listPresets(): CameraPreset[];
+    /**
+     * Delete a preset
+     */
+    deletePreset(name: string): boolean;
+    /**
+     * Import presets from JSON
+     */
+    importPresets(data: CameraPresetCollection): void;
+    /**
+     * Export presets to JSON
+     */
+    exportPresets(): CameraPresetCollection;
+    /**
+     * Clear all presets
+     */
+    clear(): void;
+}
+export declare const cameraPresets: CameraPresetManager;
+/**
+ * Default presets for common viewpoints
+ */
+export declare const DEFAULT_PRESETS: CameraPreset[];
+export {};
+//# sourceMappingURL=camera-presets.d.ts.map

package/dist/camera-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-presets.d.ts","sourceRoot":"","sources":["../src/camera-presets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,cAAM,mBAAmB;IACvB,OAAO,CAAC,OAAO,CAAwC;IAEvD;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAKtC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIlD;;OAEG;IACH,WAAW,IAAI,YAAY,EAAE;IAM7B;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAInC;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,sBAAsB,GAAG,IAAI;IAMjD;;OAEG;IACH,aAAa,IAAI,sBAAsB;IAWvC;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAGD,eAAO,MAAM,aAAa,qBAA4B,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,YAAY,EAwCzC,CAAC"}