threlte-mcp 1.4.0

package/dist/camera-presets.js

@@ -0,0 +1,114 @@
+/**
+ * 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
+ */
+/**
+ * In-memory preset storage
+ * Will be synced with browser-side storage via WebSocket
+ */
+class CameraPresetManager {
+    presets = new Map();
+    /**
+     * Save a camera preset
+     */
+    savePreset(preset) {
+        preset.timestamp = Date.now();
+        this.presets.set(preset.name, preset);
+    }
+    /**
+     * Load a camera preset by name
+     */
+    loadPreset(name) {
+        return this.presets.get(name);
+    }
+    /**
+     * List all available presets
+     */
+    listPresets() {
+        return Array.from(this.presets.values()).sort((a, b) => (b.timestamp || 0) - (a.timestamp || 0));
+    }
+    /**
+     * Delete a preset
+     */
+    deletePreset(name) {
+        return this.presets.delete(name);
+    }
+    /**
+     * Import presets from JSON
+     */
+    importPresets(data) {
+        for (const [name, preset] of Object.entries(data.presets)) {
+            this.presets.set(name, preset);
+        }
+    }
+    /**
+     * Export presets to JSON
+     */
+    exportPresets() {
+        const presets = {};
+        for (const [name, preset] of this.presets) {
+            presets[name] = preset;
+        }
+        return {
+            presets,
+            lastModified: Date.now()
+        };
+    }
+    /**
+     * Clear all presets
+     */
+    clear() {
+        this.presets.clear();
+    }
+}
+// Singleton instance
+export const cameraPresets = new CameraPresetManager();
+/**
+ * Default presets for common viewpoints
+ */
+export const DEFAULT_PRESETS = [
+    {
+        name: 'overhead',
+        position: [0, 50, 0],
+        lookAt: [0, 0, 0],
+        description: 'Top-down orthographic-style view'
+    },
+    {
+        name: 'front',
+        position: [0, 5, 20],
+        lookAt: [0, 0, 0],
+        description: 'Front view of scene origin'
+    },
+    {
+        name: 'side',
+        position: [20, 5, 0],
+        lookAt: [0, 0, 0],
+        description: 'Side view of scene origin'
+    },
+    {
+        name: 'perspective',
+        position: [15, 10, 15],
+        lookAt: [0, 0, 0],
+        fov: 50,
+        description: 'Diagonal perspective view'
+    },
+    {
+        name: 'closeup',
+        position: [3, 2, 3],
+        lookAt: [0, 0, 0],
+        fov: 35,
+        description: 'Close-up view for detail inspection'
+    },
+    {
+        name: 'wideangle',
+        position: [30, 15, 30],
+        lookAt: [0, 0, 0],
+        fov: 75,
+        description: 'Wide-angle scene overview'
+    }
+];
+// Load default presets on initialization
+DEFAULT_PRESETS.forEach(preset => cameraPresets.savePreset(preset));
+//# sourceMappingURL=camera-presets.js.map

package/dist/camera-presets.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * threlte-mcp setup CLI
+ *
+ * Auto-generates MCP configuration for your IDE.
+ *
+ * Usage:
+ *   npx threlte-mcp setup
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+/**
+ * threlte-mcp setup CLI
+ *
+ * Auto-generates MCP configuration for your IDE.
+ *
+ * Usage:
+ *   npx threlte-mcp setup
+ */
+import { promises as fs } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+const THRELTE_MCP_CONFIG = {
+    command: 'npx',
+    args: ['-y', 'threlte-mcp'],
+};
+async function exists(path) {
+    try {
+        await fs.access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function findConfigPath() {
+    const home = homedir();
+    // Antigravity (Gemini)
+    const antigravityDir = join(home, '.gemini', 'antigravity');
+    if (await exists(antigravityDir)) {
+        return { path: join(antigravityDir, 'mcp_config.json'), type: 'antigravity' };
+    }
+    // Cursor
+    const cursorDir = join(home, '.cursor');
+    if (await exists(cursorDir)) {
+        return { path: join(cursorDir, 'mcp.json'), type: 'cursor' };
+    }
+    // Claude Desktop
+    const claudeDirWin = join(home, 'AppData', 'Roaming', 'Claude');
+    if (await exists(claudeDirWin)) {
+        return { path: join(claudeDirWin, 'claude_desktop_config.json'), type: 'claude' };
+    }
+    const claudeDirMac = join(home, 'Library', 'Application Support', 'Claude');
+    if (await exists(claudeDirMac)) {
+        return { path: join(claudeDirMac, 'claude_desktop_config.json'), type: 'claude' };
+    }
+    // Fall back to project-level config
+    const projectPath = join(process.cwd(), 'mcp_config.json');
+    return { path: projectPath, type: 'generic' };
+}
+async function readConfig(path) {
+    try {
+        const content = await fs.readFile(path, 'utf-8');
+        const parsed = JSON.parse(content);
+        if (!parsed.mcpServers || typeof parsed.mcpServers !== 'object') {
+            parsed.mcpServers = {};
+        }
+        return parsed;
+    }
+    catch {
+        return { mcpServers: {} };
+    }
+}
+async function writeConfig(path, config) {
+    // Ensure directory exists
+    const dir = dirname(path);
+    await fs.mkdir(dir, { recursive: true });
+    await fs.writeFile(path, JSON.stringify(config, null, 2), 'utf-8');
+}
+async function setup() {
+    console.log('🎮 threlte-mcp Setup');
+    console.log('═══════════════════════════════════════');
+    console.log('');
+    const { path, type } = await findConfigPath();
+    console.log(`📍 Config location: ${path}`);
+    console.log(`📌 IDE type: ${type}`);
+    console.log('');
+    const config = await readConfig(path);
+    // Check if already configured
+    if (config.mcpServers['threlte-mcp'] || config.mcpServers['threlte']) {
+        console.log('✅ threlte-mcp is already configured!');
+        console.log('');
+        printNextSteps();
+        return;
+    }
+    // Add threlte-mcp config
+    config.mcpServers['threlte-mcp'] = THRELTE_MCP_CONFIG;
+    await writeConfig(path, config);
+    console.log('✅ Added threlte-mcp to your MCP configuration!');
+    console.log('');
+    printNextSteps();
+}
+function printNextSteps() {
+    console.log('═══════════════════════════════════════');
+    console.log('📋 Next Steps:');
+    console.log('');
+    console.log('1. Restart your IDE to load the new MCP server');
+    console.log('');
+    console.log('2. Add the MCPBridge component to your Threlte app:');
+    console.log('');
+    console.log('   ```svelte');
+    console.log('   <script>');
+    console.log("     import { MCPBridgeComponent } from 'threlte-mcp/client';");
+    console.log('   </script>');
+    console.log('');
+    console.log('   <MCPBridgeComponent />');
+    console.log('   ```');
+    console.log('');
+    console.log('3. Run your app in development mode (npm run dev)');
+    console.log('');
+    console.log('═══════════════════════════════════════');
+    console.log('🎮 The AI can now inspect and manipulate your scene!');
+}
+// Check if running as CLI
+const args = process.argv.slice(2);
+if (args[0] === 'setup') {
+    setup().catch((error) => {
+        console.error('❌ Setup failed:', error.message);
+        process.exit(1);
+    });
+}
+else if (args.length === 0 || args[0] === 'serve' || args[0] === 'start') {
+    // Default: run the MCP server
+    import('./index.js');
+}
+else {
+    console.log('threlte-mcp - MCP server for Three.js/Threlte scenes');
+    console.log('');
+    console.log('Commands:');
+    console.log('  npx threlte-mcp          Start the MCP server');
+    console.log('  npx threlte-mcp setup    Configure IDE for threlte-mcp');
+    console.log('');
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/client/MCPBridge.d.ts

@@ -0,0 +1,93 @@
+/**
+ * MCPBridge - Client-side WebSocket bridge for threlte-mcp
+ *
+ * Enables real-time Three.js/Threlte scene manipulation via MCP commands.
+ * Auto-connects in development mode (import.meta.env.DEV).
+ *
+ * @example
+ * ```typescript
+ * import { MCPBridge } from 'threlte-mcp/client';
+ *
+ * // Create bridge (auto-connects in dev mode)
+ * const bridge = new MCPBridge(scene);
+ *
+ * // Call update() in your render loop for animations
+ * bridge.update();
+ * ```
+ */
+import * as THREE from 'three';
+export interface MCPBridgeOptions {
+    /** WebSocket URL (default: ws://127.0.0.1:8083) */
+    url?: string;
+    /** Auto-connect on creation (default: true in dev mode) */
+    autoConnect?: boolean;
+    /** Reconnect delay in ms (default: 60000) */
+    reconnectDelay?: number;
+    /** Max tree depth for scene state (default: 10) */
+    maxDepth?: number;
+}
+interface SceneObjectData {
+    name: string;
+    path: string;
+    type: string;
+    position: string;
+    children: number;
+}
+export declare class MCPBridge {
+    private ws;
+    private scene;
+    private reconnectTimeout;
+    private options;
+    private rotatingObjects;
+    private objects;
+    private cameraTween;
+    private cameraLookAt;
+    constructor(scene: THREE.Scene, options?: MCPBridgeOptions);
+    /**
+     * Connect to the MCP WebSocket server
+     */
+    connect(): void;
+    /**
+     * Disconnect from the MCP server
+     */
+    disconnect(): void;
+    /**
+     * Update loop - call this in your render/animation loop
+     */
+    update(): void;
+    /**
+     * Check if connected to MCP server
+     */
+    isConnected(): boolean;
+    private scheduleReconnect;
+    private sendSceneState;
+    private sendResponse;
+    private handleCommand;
+    getSceneState(maxDepth?: number): SceneObjectData[];
+    findObjects(filter: {
+        name?: string;
+        nameContains?: string;
+        type?: string;
+    }): SceneObjectData[];
+    private getObjectPath;
+    private findObject;
+    private moveObject;
+    private setTransform;
+    private setVisibility;
+    private lookAt;
+    private setOpacity;
+    private getActiveCamera;
+    private getCameraLookAt;
+    private getCameraState;
+    private setCameraPosition;
+    private addPrimitive;
+    private removeObject;
+    private duplicateObject;
+    private addLight;
+}
+/**
+ * Get or create the global MCPBridge instance
+ */
+export declare function getMCPBridge(scene?: THREE.Scene): MCPBridge | null;
+export {};
+//# sourceMappingURL=MCPBridge.d.ts.map

package/dist/client/MCPBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MCPBridge.d.ts","sourceRoot":"","sources":["../../client/MCPBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,gBAAgB;IAC7B,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAQD,UAAU,eAAe;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAiBD,qBAAa,SAAS;IAClB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,eAAe,CAA6C;IACpE,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,YAAY,CAA8B;gBAEtC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,GAAE,gBAAqB;IA2B9D;;OAEG;IACH,OAAO,IAAI,IAAI;IA+Bf;;OAEG;IACH,UAAU,IAAI,IAAI;IAWlB;;OAEG;IACH,MAAM,IAAI,IAAI;IA0Dd;;OAEG;IACH,WAAW,IAAI,OAAO;IAQtB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,aAAa;IA8FrB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE;IA8BnD,WAAW,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe,EAAE;IAyB/F,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,UAAU;IAgBlB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,UAAU;IAkBlB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,cAAc;IAqBtB,OAAO,CAAC,iBAAiB;IAkFzB,OAAO,CAAC,YAAY;IAuCpB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,eAAe;IAuBvB,OAAO,CAAC,QAAQ;CAiCnB;AAYD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,SAAS,GAAG,IAAI,CAOlE"}