figma-console-mcp 0.1.0

package/dist/core/figma-desktop-connector.js

@@ -0,0 +1,384 @@
+/**
+ * Figma Desktop Connector
+ *
+ * This service connects directly to Figma Desktop's plugin context
+ * to execute code with access to the full Figma Plugin API,
+ * including variables without Enterprise access.
+ *
+ * Uses Puppeteer's Worker API to directly access plugin workers,
+ * bypassing CDP context enumeration limitations.
+ */
+import { logger } from './logger.js';
+export class FigmaDesktopConnector {
+    constructor(page) {
+        this.page = page;
+    }
+    /**
+     * Initialize connection to Figma Desktop's plugin context
+     * No setup needed - Puppeteer handles worker access automatically
+     */
+    async initialize() {
+        logger.info('Figma Desktop connector initialized (using Puppeteer Worker API)');
+    }
+    /**
+     * Execute code in Figma's plugin context where the figma API is available
+     * Uses Puppeteer's direct worker access instead of CDP context enumeration
+     */
+    async executeInPluginContext(code) {
+        try {
+            // Use Puppeteer's worker API directly - this can access plugin workers
+            // that CDP's Runtime.getExecutionContexts cannot enumerate
+            const workers = this.page.workers();
+            // Log to browser console so MCP can capture it
+            await this.page.evaluate((count, urls) => {
+                console.log(`[DESKTOP_CONNECTOR] Found ${count} workers via Puppeteer API:`, urls);
+            }, workers.length, workers.map(w => w.url()));
+            logger.info({
+                workerCount: workers.length,
+                workerUrls: workers.map(w => w.url())
+            }, 'Found workers via Puppeteer API');
+            // Try each worker to find one with figma API
+            for (const worker of workers) {
+                try {
+                    // Log to browser console
+                    await this.page.evaluate((url) => {
+                        console.log(`[DESKTOP_CONNECTOR] Checking worker: ${url}`);
+                    }, worker.url());
+                    // Check if this worker has the figma API
+                    // Use string evaluation to avoid TypeScript errors about figma global
+                    const hasFigmaApi = await worker.evaluate('typeof figma !== "undefined"');
+                    // Log result to browser console
+                    await this.page.evaluate((url, hasApi) => {
+                        console.log(`[DESKTOP_CONNECTOR] Worker ${url} has figma API: ${hasApi}`);
+                    }, worker.url(), hasFigmaApi);
+                    if (hasFigmaApi) {
+                        logger.info({ workerUrl: worker.url() }, 'Found worker with Figma API');
+                        await this.page.evaluate((url) => {
+                            console.log(`[DESKTOP_CONNECTOR] ✅ SUCCESS! Found worker with Figma API: ${url}`);
+                        }, worker.url());
+                        // Execute the code in this worker context
+                        // Wrap the code in a function to ensure proper evaluation
+                        const wrappedCode = `(${code})`;
+                        const result = await worker.evaluate(wrappedCode);
+                        return result;
+                    }
+                }
+                catch (workerError) {
+                    // This worker doesn't have figma API or evaluation failed, try next
+                    await this.page.evaluate((url, err) => {
+                        console.error(`[DESKTOP_CONNECTOR] ❌ Worker ${url} check failed:`, err);
+                    }, worker.url(), workerError instanceof Error ? workerError.message : String(workerError));
+                    logger.error({ error: workerError, workerUrl: worker.url() }, 'Worker check failed, trying next');
+                    continue;
+                }
+            }
+            // If no worker found with figma API, throw error
+            throw new Error('No plugin worker found with Figma API. Make sure a plugin is running in Figma Desktop.');
+        }
+        catch (error) {
+            logger.error({ error, code: code.substring(0, 200) }, 'Failed to execute in plugin context');
+            throw error;
+        }
+    }
+    /**
+     * Get Figma variables from plugin UI window object
+     * This bypasses Figma's plugin sandbox security restrictions
+     * by accessing data that the plugin posted to its UI iframe
+     */
+    async getVariablesFromPluginUI(fileKey) {
+        try {
+            // Log to browser console
+            await this.page.evaluate((key) => {
+                console.log(`[DESKTOP_CONNECTOR] 🚀 getVariablesFromPluginUI() called, fileKey: ${key}`);
+            }, fileKey);
+            logger.info({ fileKey }, 'Getting variables from plugin UI iframe');
+            // Get all frames (iframes) in the page
+            const frames = this.page.frames();
+            await this.page.evaluate((count) => {
+                console.log(`[DESKTOP_CONNECTOR] Found ${count} frames (iframes)`);
+            }, frames.length);
+            logger.info({ frameCount: frames.length }, 'Found frames in page');
+            // Try to find plugin UI iframe with variables data
+            for (const frame of frames) {
+                try {
+                    const frameUrl = frame.url();
+                    await this.page.evaluate((url) => {
+                        console.log(`[DESKTOP_CONNECTOR] Checking frame: ${url}`);
+                    }, frameUrl);
+                    // Check if this frame has our variables data
+                    const hasData = await frame.evaluate('typeof window.__figmaVariablesData !== "undefined" && window.__figmaVariablesReady === true');
+                    await this.page.evaluate((url, has) => {
+                        console.log(`[DESKTOP_CONNECTOR] Frame ${url} has variables data: ${has}`);
+                    }, frameUrl, hasData);
+                    if (hasData) {
+                        logger.info({ frameUrl }, 'Found frame with variables data');
+                        await this.page.evaluate((url) => {
+                            console.log(`[DESKTOP_CONNECTOR] ✅ SUCCESS! Found plugin UI with variables data: ${url}`);
+                        }, frameUrl);
+                        // Get the data from window object
+                        const result = await frame.evaluate('window.__figmaVariablesData');
+                        logger.info({
+                            variableCount: result.variables?.length,
+                            collectionCount: result.variableCollections?.length
+                        }, 'Successfully retrieved variables from plugin UI');
+                        await this.page.evaluate((varCount, collCount) => {
+                            console.log(`[DESKTOP_CONNECTOR] ✅ Retrieved ${varCount} variables in ${collCount} collections`);
+                        }, result.variables?.length || 0, result.variableCollections?.length || 0);
+                        return result;
+                    }
+                }
+                catch (frameError) {
+                    await this.page.evaluate((url, err) => {
+                        console.log(`[DESKTOP_CONNECTOR] Frame ${url} check failed: ${err}`);
+                    }, frame.url(), frameError instanceof Error ? frameError.message : String(frameError));
+                    logger.debug({ error: frameError, frameUrl: frame.url() }, 'Frame check failed, trying next');
+                    continue;
+                }
+            }
+            // If no frame found with data, throw error
+            throw new Error('No plugin UI found with variables data. Make sure the Variables Exporter (Persistent) plugin is running.');
+        }
+        catch (error) {
+            logger.error({ error }, 'Failed to get variables from plugin UI');
+            await this.page.evaluate((msg) => {
+                console.error('[DESKTOP_CONNECTOR] ❌ getVariablesFromPluginUI failed:', msg);
+            }, error instanceof Error ? error.message : String(error));
+            throw error;
+        }
+    }
+    /**
+     * Get component data by node ID from plugin UI window object
+     * This bypasses the REST API bug where descriptions are missing
+     * by accessing data from the Desktop Bridge plugin via its UI iframe
+     */
+    async getComponentFromPluginUI(nodeId) {
+        try {
+            // Log to browser console
+            await this.page.evaluate((id) => {
+                console.log(`[DESKTOP_CONNECTOR] 🎯 getComponentFromPluginUI() called, nodeId: ${id}`);
+            }, nodeId);
+            logger.info({ nodeId }, 'Getting component from plugin UI iframe');
+            // Get all frames (iframes) in the page
+            const frames = this.page.frames();
+            await this.page.evaluate((count) => {
+                console.log(`[DESKTOP_CONNECTOR] Found ${count} frames (iframes)`);
+            }, frames.length);
+            logger.info({ frameCount: frames.length }, 'Found frames in page');
+            // Try to find plugin UI iframe with requestComponentData function
+            for (const frame of frames) {
+                try {
+                    const frameUrl = frame.url();
+                    await this.page.evaluate((url) => {
+                        console.log(`[DESKTOP_CONNECTOR] Checking frame: ${url}`);
+                    }, frameUrl);
+                    // Check if this frame has our requestComponentData function
+                    const hasFunction = await frame.evaluate('typeof window.requestComponentData === "function"');
+                    await this.page.evaluate((url, has) => {
+                        console.log(`[DESKTOP_CONNECTOR] Frame ${url} has requestComponentData: ${has}`);
+                    }, frameUrl, hasFunction);
+                    if (hasFunction) {
+                        logger.info({ frameUrl }, 'Found frame with requestComponentData function');
+                        await this.page.evaluate((url) => {
+                            console.log(`[DESKTOP_CONNECTOR] ✅ SUCCESS! Found plugin UI with requestComponentData: ${url}`);
+                        }, frameUrl);
+                        // Call the function with the nodeId - it returns a Promise
+                        // Use JSON.stringify to safely pass the nodeId as a string literal
+                        const result = await frame.evaluate(`window.requestComponentData(${JSON.stringify(nodeId)})`);
+                        logger.info({
+                            nodeId,
+                            componentName: result.component?.name,
+                            hasDescription: !!result.component?.description
+                        }, 'Successfully retrieved component from plugin UI');
+                        await this.page.evaluate((name, hasDesc) => {
+                            console.log(`[DESKTOP_CONNECTOR] ✅ Retrieved component "${name}", has description: ${hasDesc}`);
+                        }, result.component?.name, !!result.component?.description);
+                        return result;
+                    }
+                }
+                catch (frameError) {
+                    await this.page.evaluate((url, err) => {
+                        console.log(`[DESKTOP_CONNECTOR] Frame ${url} check failed: ${err}`);
+                    }, frame.url(), frameError instanceof Error ? frameError.message : String(frameError));
+                    logger.debug({ error: frameError, frameUrl: frame.url() }, 'Frame check failed, trying next');
+                    continue;
+                }
+            }
+            // If no frame found with function, throw error
+            throw new Error('No plugin UI found with requestComponentData function. Make sure the Desktop Bridge plugin is running.');
+        }
+        catch (error) {
+            logger.error({ error, nodeId }, 'Failed to get component from plugin UI');
+            await this.page.evaluate((msg) => {
+                console.error('[DESKTOP_CONNECTOR] ❌ getComponentFromPluginUI failed:', msg);
+            }, error instanceof Error ? error.message : String(error));
+            throw error;
+        }
+    }
+    /**
+     * Get Figma variables using the desktop connection
+     * This bypasses the Enterprise requirement!
+     */
+    async getVariables(fileKey) {
+        // Log to browser console
+        await this.page.evaluate((key) => {
+            console.log(`[DESKTOP_CONNECTOR] 🚀 getVariables() called, fileKey: ${key}`);
+        }, fileKey);
+        logger.info({ fileKey }, 'Getting variables via Desktop connection');
+        const code = `
+      (async () => {
+        try {
+          // Check if we're in the right context
+          if (typeof figma === 'undefined') {
+            throw new Error('Figma API not available in this context');
+          }
+
+          // Get variables just like the official MCP does
+          const variables = await figma.variables.getLocalVariablesAsync();
+          const collections = await figma.variables.getLocalVariableCollectionsAsync();
+
+          // Format the response
+          const result = {
+            success: true,
+            timestamp: Date.now(),
+            variables: variables.map(v => ({
+              id: v.id,
+              name: v.name,
+              key: v.key,
+              resolvedType: v.resolvedType,
+              valuesByMode: v.valuesByMode,
+              variableCollectionId: v.variableCollectionId,
+              scopes: v.scopes,
+              description: v.description,
+              hiddenFromPublishing: v.hiddenFromPublishing
+            })),
+            variableCollections: collections.map(c => ({
+              id: c.id,
+              name: c.name,
+              key: c.key,
+              modes: c.modes,
+              defaultModeId: c.defaultModeId,
+              variableIds: c.variableIds
+            }))
+          };
+
+          return result;
+        } catch (error) {
+          return {
+            success: false,
+            error: error.message
+          };
+        }
+      })()
+    `;
+        try {
+            const result = await this.executeInPluginContext(code);
+            if (!result.success) {
+                throw new Error(result.error || 'Failed to get variables');
+            }
+            logger.info({
+                variableCount: result.variables?.length,
+                collectionCount: result.variableCollections?.length
+            }, 'Successfully retrieved variables via Desktop');
+            return result;
+        }
+        catch (error) {
+            logger.error({ error }, 'Failed to get variables via Desktop');
+            throw error;
+        }
+    }
+    /**
+     * Clean up resources (no-op since we use Puppeteer's built-in worker management)
+     */
+    /**
+     * Get component data by node ID using Plugin API
+     * This bypasses the REST API bug where descriptions are missing
+     */
+    async getComponentByNodeId(nodeId) {
+        await this.page.evaluate((id) => {
+            console.log(`[DESKTOP_CONNECTOR] 🎯 getComponentByNodeId() called, nodeId: ${id}`);
+        }, nodeId);
+        logger.info({ nodeId }, 'Getting component via Desktop Plugin API');
+        const code = `
+      (async () => {
+        try {
+          // Check if we're in the right context
+          if (typeof figma === 'undefined') {
+            throw new Error('Figma API not available in this context');
+          }
+
+          // Get the node by ID
+          const node = figma.getNodeById('${nodeId}');
+          
+          if (!node) {
+            throw new Error('Node not found with ID: ${nodeId}');
+          }
+
+          // Check if it's a component-like node
+          if (node.type !== 'COMPONENT' && node.type !== 'COMPONENT_SET' && node.type !== 'INSTANCE') {
+            throw new Error('Node is not a component, component set, or instance. Type: ' + node.type);
+          }
+
+          // Extract component data including description fields
+          const result = {
+            success: true,
+            timestamp: Date.now(),
+            component: {
+              id: node.id,
+              name: node.name,
+              type: node.type,
+              description: node.description || null,
+              descriptionMarkdown: node.descriptionMarkdown || null,
+              // Include other useful properties
+              visible: node.visible,
+              locked: node.locked,
+              // For components with properties
+              componentPropertyDefinitions: node.type === 'COMPONENT' || node.type === 'COMPONENT_SET' 
+                ? node.componentPropertyDefinitions 
+                : undefined,
+              // Get children info (lightweight)
+              children: node.children ? node.children.map(child => ({
+                id: child.id,
+                name: child.name,
+                type: child.type
+              })) : undefined
+            }
+          };
+
+          return result;
+        } catch (error) {
+          return {
+            success: false,
+            error: error.message,
+            stack: error.stack
+          };
+        }
+      })()
+    `;
+        try {
+            const result = await this.executeInPluginContext(code);
+            if (!result.success) {
+                throw new Error(result.error || 'Failed to get component data');
+            }
+            logger.info({
+                nodeId,
+                componentName: result.component?.name,
+                hasDescription: !!result.component?.description
+            }, 'Successfully retrieved component via Desktop Plugin API');
+            await this.page.evaluate((name, hasDesc) => {
+                console.log(`[DESKTOP_CONNECTOR] ✅ Retrieved component "${name}", has description: ${hasDesc}`);
+            }, result.component?.name, !!result.component?.description);
+            return result;
+        }
+        catch (error) {
+            logger.error({ error, nodeId }, 'Failed to get component via Desktop Plugin API');
+            await this.page.evaluate((id, err) => {
+                console.error(`[DESKTOP_CONNECTOR] ❌ getComponentByNodeId failed for ${id}:`, err);
+            }, nodeId, error instanceof Error ? error.message : String(error));
+            throw error;
+        }
+    }
+    async dispose() {
+        logger.info('Figma Desktop connector disposed');
+    }
+}
+//# sourceMappingURL=figma-desktop-connector.js.map

package/dist/core/figma-desktop-connector.js.map

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

package/dist/core/figma-style-extractor.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Figma Style Extractor
+ *
+ * Extracts style information (colors, typography, spacing) from Figma files
+ * using the REST API /files endpoint. This provides an alternative to the
+ * Enterprise-only Variables API by parsing style data directly from nodes.
+ *
+ * Based on the approach used by Figma-Context-MCP
+ */
+interface ExtractedVariable {
+    id: string;
+    name: string;
+    value: string;
+    type: 'COLOR' | 'TYPOGRAPHY' | 'SPACING' | 'RADIUS' | 'EFFECT';
+    category?: string;
+    description?: string;
+    nodeId?: string;
+}
+export declare class FigmaStyleExtractor {
+    private extractedVariables;
+    private colorIndex;
+    private typographyIndex;
+    private spacingIndex;
+    private radiusIndex;
+    /**
+     * Extract style "variables" from Figma file data
+     * This mimics what users would see as variables in Figma
+     */
+    extractStylesFromFile(fileData: any): Promise<ExtractedVariable[]>;
+    /**
+     * Process a single node and extract style information
+     */
+    private processNode;
+    /**
+     * Extract color variable
+     */
+    private extractColor;
+    /**
+     * Extract typography variable
+     */
+    private extractTypography;
+    /**
+     * Extract spacing variable
+     */
+    private extractSpacing;
+    /**
+     * Extract radius variable
+     */
+    private extractRadius;
+    /**
+     * Process Figma styles object
+     */
+    private processStyles;
+    /**
+     * Helper to infer color category from node name
+     */
+    private inferColorCategory;
+    /**
+     * Generate a meaningful color name
+     */
+    private generateColorName;
+    /**
+     * Generate a meaningful typography name
+     */
+    private generateTypographyName;
+    /**
+     * Categorize radius values
+     */
+    private categorizeRadius;
+    /**
+     * Format the extracted variables for output
+     */
+    formatVariablesAsOutput(variables: ExtractedVariable[]): any;
+}
+export {};
+//# sourceMappingURL=figma-style-extractor.d.ts.map

package/dist/core/figma-style-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-style-extractor.d.ts","sourceRoot":"","sources":["../../src/core/figma-style-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAqDH,UAAU,iBAAiB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,kBAAkB,CAA6C;IACvE,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,WAAW,CAAK;IAExB;;;OAGG;IACG,qBAAqB,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAiDxE;;OAEG;IACH,OAAO,CAAC,WAAW;IAwDnB;;OAEG;IACH,OAAO,CAAC,YAAY;IA6BpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0BzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAkBtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAoBrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiB9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,uBAAuB,CAAC,SAAS,EAAE,iBAAiB,EAAE,GAAG,GAAG;CAyB7D"}