figma-console-mcp 0.1.0

package/dist/core/types/index.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Type definitions for Figma Console MCP
+ */
+/**
+ * Console log entry captured from Figma plugin
+ */
+export interface ConsoleLogEntry {
+    timestamp: number;
+    level: 'log' | 'info' | 'warn' | 'error' | 'debug';
+    message: string;
+    args: any[];
+    stackTrace?: StackTrace;
+    source: 'plugin' | 'figma' | 'page' | 'unknown';
+    workerUrl?: string;
+}
+/**
+ * Stack trace information
+ */
+export interface StackTrace {
+    callFrames: CallFrame[];
+}
+/**
+ * Individual stack frame
+ */
+export interface CallFrame {
+    functionName: string;
+    url: string;
+    lineNumber: number;
+    columnNumber: number;
+}
+/**
+ * Screenshot metadata
+ */
+export interface Screenshot {
+    id: string;
+    timestamp: number;
+    path: string;
+    format: 'png' | 'jpeg';
+    width: number;
+    height: number;
+    selector?: string;
+    base64?: string;
+    metadata?: ScreenshotMetadata;
+}
+/**
+ * Additional screenshot metadata
+ */
+export interface ScreenshotMetadata {
+    pluginName?: string;
+    pluginId?: string;
+    figmaFileKey?: string;
+}
+/**
+ * Plugin context information
+ */
+export interface PluginContext {
+    pluginId?: string;
+    pluginName?: string;
+    isRunning: boolean;
+    lastReloadTime?: number;
+}
+/**
+ * Server configuration
+ */
+export interface ServerConfig {
+    mode: 'local' | 'cloudflare';
+    browser: BrowserConfig;
+    console: ConsoleConfig;
+    screenshots: ScreenshotConfig;
+    local?: LocalModeConfig;
+}
+/**
+ * Browser configuration
+ */
+export interface BrowserConfig {
+    headless: boolean;
+    args: string[];
+    executablePath?: string;
+}
+/**
+ * Local mode configuration
+ */
+export interface LocalModeConfig {
+    debugHost: string;
+    debugPort: number;
+}
+/**
+ * Console monitoring configuration
+ */
+export interface ConsoleConfig {
+    bufferSize: number;
+    filterLevels: ConsoleLogEntry['level'][];
+    truncation: TruncationConfig;
+}
+/**
+ * Screenshot configuration
+ */
+export interface ScreenshotConfig {
+    defaultFormat: 'png' | 'jpeg';
+    quality: number;
+    storePath: string;
+}
+/**
+ * Log truncation configuration
+ */
+export interface TruncationConfig {
+    maxStringLength: number;
+    maxArrayLength: number;
+    maxObjectDepth: number;
+    removeDuplicates: boolean;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/core/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,GAAG,YAAY,CAAC;IAC7B,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;IACzC,UAAU,EAAE,gBAAgB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,KAAK,GAAG,MAAM,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;CAC3B"}

package/dist/core/types/index.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for Figma Console MCP
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/core/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Figma Console MCP Server
+ * Entry point for the MCP server that enables AI assistants to access
+ * Figma plugin console logs and screenshots.
+ */
+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;;;;GAIG"}

package/dist/index.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Figma Console MCP Server
+ * Entry point for the MCP server that enables AI assistants to access
+ * Figma plugin console logs and screenshots.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const server_js_1 = require("./server.js");
+const logger_js_1 = require("./logger.js");
+/**
+ * Global server instance for cleanup
+ */
+let server = null;
+/**
+ * Graceful shutdown handler
+ */
+async function shutdown(signal) {
+    logger_js_1.logger.info({ signal }, 'Received shutdown signal');
+    if (server) {
+        try {
+            await server.close();
+            logger_js_1.logger.info('Server shut down gracefully');
+        }
+        catch (error) {
+            logger_js_1.logger.error({ error }, 'Error during shutdown');
+            process.exit(1);
+        }
+    }
+    process.exit(0);
+}
+/**
+ * Main function to start the server
+ */
+async function main() {
+    try {
+        logger_js_1.logger.info('Starting Figma Console MCP Server...');
+        logger_js_1.logger.info('Version: 0.1.0');
+        logger_js_1.logger.info('Node version: %s', process.version);
+        // Create server instance
+        server = new server_js_1.FigmaConsoleMCPServer();
+        // Set up graceful shutdown handlers
+        process.on('SIGINT', () => shutdown('SIGINT'));
+        process.on('SIGTERM', () => shutdown('SIGTERM'));
+        // Handle uncaught errors
+        process.on('uncaughtException', (error) => {
+            logger_js_1.logger.fatal({ error }, 'Uncaught exception');
+            process.exit(1);
+        });
+        process.on('unhandledRejection', (reason) => {
+            logger_js_1.logger.fatal({ reason }, 'Unhandled promise rejection');
+            process.exit(1);
+        });
+        // Create stdio transport
+        const transport = new stdio_js_1.StdioServerTransport();
+        // Connect server to transport
+        await server.connect(transport);
+        logger_js_1.logger.info('Figma Console MCP server is running');
+        logger_js_1.logger.info('Ready to accept MCP tool calls via stdio');
+        logger_js_1.logger.info('Press Ctrl+C to stop the server');
+        // Keep process alive
+        // The server will run until killed or an error occurs
+    }
+    catch (error) {
+        logger_js_1.logger.fatal({ error }, 'Fatal error starting server');
+        process.exit(1);
+    }
+}
+// Start the server
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAEA;;;;GAIG;;AAEH,wEAAiF;AACjF,2CAAoD;AACpD,2CAAqC;AAErC;;GAEG;AACH,IAAI,MAAM,GAAiC,IAAI,CAAC;AAEhD;;GAEG;AACH,KAAK,UAAU,QAAQ,CAAC,MAAc;IACpC,kBAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,0BAA0B,CAAC,CAAC;IAEpD,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,kBAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,kBAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,uBAAuB,CAAC,CAAC;YACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,kBAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACpD,kBAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC9B,kBAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAEjD,yBAAyB;QACzB,MAAM,GAAG,IAAI,iCAAqB,EAAE,CAAC;QAErC,oCAAoC;QACpC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;QAEjD,yBAAyB;QACzB,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;YACxC,kBAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,oBAAoB,CAAC,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;YAC1C,kBAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,6BAA6B,CAAC,CAAC;YACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,yBAAyB;QACzB,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;QAE7C,8BAA8B;QAC9B,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEhC,kBAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QACnD,kBAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QACxD,kBAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAE/C,qBAAqB;QACrB,sDAAsD;IACxD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,kBAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,6BAA6B,CAAC,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,mBAAmB;AACnB,IAAI,EAAE,CAAC"}

package/dist/local.d.ts

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+/**
+ * Figma Console MCP Server - Local Mode
+ *
+ * Entry point for local MCP server that connects to Figma Desktop
+ * via Chrome Remote Debugging Protocol (port 9222).
+ *
+ * This implementation uses stdio transport for MCP communication,
+ * suitable for local IDE integrations and development workflows.
+ *
+ * Requirements:
+ * - Figma Desktop must be launched with: --remote-debugging-port=9222
+ * - "Use Developer VM" enabled in Figma: Plugins → Development → Use Developer VM
+ * - FIGMA_ACCESS_TOKEN environment variable for API access
+ *
+ * macOS launch command:
+ *   open -a "Figma" --args --remote-debugging-port=9222
+ */
+/**
+ * Local MCP Server
+ * Connects to Figma Desktop and provides identical tools to Cloudflare mode
+ */
+declare class LocalFigmaConsoleMCP {
+    private server;
+    private browserManager;
+    private consoleMonitor;
+    private figmaAPI;
+    private config;
+    private variablesCache;
+    constructor();
+    /**
+     * Get or create Figma API client
+     */
+    private getFigmaAPI;
+    /**
+     * Check if Figma Desktop is accessible
+     */
+    private checkFigmaDesktop;
+    /**
+     * Initialize browser and console monitoring
+     */
+    private ensureInitialized;
+    /**
+     * Register all MCP tools
+     */
+    private registerTools;
+    /**
+     * Start the MCP server
+     */
+    start(): Promise<void>;
+    /**
+     * Cleanup and shutdown
+     */
+    shutdown(): Promise<void>;
+}
+export { LocalFigmaConsoleMCP };
+//# sourceMappingURL=local.d.ts.map

package/dist/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../src/local.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;GAgBG;AAcH;;;GAGG;AACH,cAAM,oBAAoB;IACzB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,MAAM,CAAe;IAI7B,OAAO,CAAC,cAAc,CAGP;;IASf;;OAEG;YACW,WAAW;IAuBzB;;OAEG;YACW,iBAAiB;IAsC/B;;OAEG;YACW,iBAAiB;IA+B/B;;OAEG;IACH,OAAO,CAAC,aAAa;IA8lBrB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8B5B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAiB/B;AA+BD,OAAO,EAAE,oBAAoB,EAAE,CAAC"}