@obra-studio/figma-console-mcp 1.32.0

package/dist/core/comment-tools.js

@@ -0,0 +1,293 @@
+/**
+ * Figma Comments MCP Tools
+ * Tools for getting, posting, and deleting comments on Figma files via REST API.
+ * Works in both local and Cloudflare Workers modes — no Plugin API dependency.
+ */
+import { z } from "zod";
+import { extractFileKey } from "./figma-api.js";
+import { createChildLogger } from "./logger.js";
+const logger = createChildLogger({ component: "comment-tools" });
+// ============================================================================
+// Tool Registration
+// ============================================================================
+export function registerCommentTools(server, getFigmaAPI, getCurrentUrl, options) {
+    // -----------------------------------------------------------------------
+    // Tool: figma_get_comments
+    // -----------------------------------------------------------------------
+    server.tool("figma_get_comments", "Get comments on a Figma file. Returns comment threads with author, message, timestamps, and pinned node locations. Use include_resolved to also see resolved comments.", {
+        fileUrl: z
+            .string()
+            .url()
+            .optional()
+            .describe("Figma file URL. Uses current URL if omitted."),
+        as_md: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Return comment message bodies as markdown. Default: false"),
+        include_resolved: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Include resolved (completed) comment threads. Default: false (only active comments)"),
+    }, async ({ fileUrl, as_md = false, include_resolved = false }) => {
+        try {
+            const url = fileUrl || getCurrentUrl();
+            if (!url) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                error: "no_file_url",
+                                message: "No Figma file URL available. Pass the fileUrl parameter or ensure the Desktop Bridge plugin is open in Figma.",
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const fileKey = extractFileKey(url);
+            if (!fileKey) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                error: "invalid_url",
+                                message: `Invalid Figma URL: ${url}`,
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            logger.info({ fileKey, as_md, include_resolved }, "Fetching comments");
+            const api = await getFigmaAPI();
+            const response = await api.getComments(fileKey, { as_md });
+            const allComments = response.comments || [];
+            // Filter out resolved comments unless explicitly requested
+            const comments = include_resolved
+                ? allComments
+                : allComments.filter((c) => !c.resolved_at);
+            const result = {
+                comments,
+                summary: {
+                    total: allComments.length,
+                    active: allComments.filter((c) => !c.resolved_at).length,
+                    resolved: allComments.filter((c) => c.resolved_at).length,
+                    returned: comments.length,
+                },
+            };
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error({ error }, "Failed to get comments");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: "get_comments_failed",
+                            message: `Cannot get comments. ${message}`,
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // -----------------------------------------------------------------------
+    // Tool: figma_post_comment
+    // -----------------------------------------------------------------------
+    server.tool("figma_post_comment", "Post a comment on a Figma file, optionally pinned to a specific design node. Use after figma_check_design_parity to notify designers of drift when code is the canonical source. Supports replies to existing comment threads. Limitation: @mentions are a Figma UI-only feature — including '@name' in the message renders as plain text, not a clickable mention tag, and does not trigger Figma notifications.", {
+        fileUrl: z
+            .string()
+            .url()
+            .optional()
+            .describe("Figma file URL. Uses current URL if omitted."),
+        message: z
+            .string()
+            .describe("The comment message text. Supports basic formatting."),
+        node_id: z
+            .string()
+            .optional()
+            .describe("Node ID to pin the comment to (e.g., '695:313'). Comment appears on that element in Figma."),
+        x: z
+            .number()
+            .optional()
+            .describe("X coordinate for comment placement (absolute canvas position). Used with node_id."),
+        y: z
+            .number()
+            .optional()
+            .describe("Y coordinate for comment placement (absolute canvas position). Used with node_id."),
+        reply_to_comment_id: z
+            .string()
+            .optional()
+            .describe("ID of an existing comment to reply to. Creates a threaded reply instead of a new top-level comment."),
+    }, async ({ fileUrl, message, node_id, x, y, reply_to_comment_id }) => {
+        try {
+            const url = fileUrl || getCurrentUrl();
+            if (!url) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                error: "no_file_url",
+                                message: "No Figma file URL available. Pass the fileUrl parameter or ensure the Desktop Bridge plugin is open in Figma.",
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const fileKey = extractFileKey(url);
+            if (!fileKey) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                error: "invalid_url",
+                                message: `Invalid Figma URL: ${url}`,
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            logger.info({ fileKey, node_id, reply_to_comment_id }, "Posting comment");
+            const api = await getFigmaAPI();
+            // Build client_meta for pinning to a node/position
+            // Figma API requires node_offset when node_id is present — default to (0,0) if not specified
+            let clientMeta;
+            if (node_id) {
+                clientMeta = {
+                    node_id,
+                    node_offset: { x: x ?? 0, y: y ?? 0 },
+                };
+            }
+            const result = await api.postComment(fileKey, message, clientMeta, reply_to_comment_id);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            comment: {
+                                id: result.id,
+                                message: result.message,
+                                created_at: result.created_at,
+                                user: result.user,
+                                client_meta: result.client_meta,
+                                order_id: result.order_id,
+                            },
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message_text = error instanceof Error ? error.message : String(error);
+            logger.error({ error }, "Failed to post comment");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: "post_comment_failed",
+                            message: `Cannot post comment. ${message_text}`,
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // -----------------------------------------------------------------------
+    // Tool: figma_delete_comment
+    // -----------------------------------------------------------------------
+    server.tool("figma_delete_comment", "Delete a comment from a Figma file by its comment ID. Use figma_get_comments to find comment IDs first.", {
+        fileUrl: z
+            .string()
+            .url()
+            .optional()
+            .describe("Figma file URL. Uses current URL if omitted."),
+        comment_id: z
+            .string()
+            .describe("The ID of the comment to delete. Get IDs from figma_get_comments."),
+    }, async ({ fileUrl, comment_id }) => {
+        try {
+            const url = fileUrl || getCurrentUrl();
+            if (!url) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                error: "no_file_url",
+                                message: "No Figma file URL available. Pass the fileUrl parameter or ensure the Desktop Bridge plugin is open in Figma.",
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const fileKey = extractFileKey(url);
+            if (!fileKey) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                error: "invalid_url",
+                                message: `Invalid Figma URL: ${url}`,
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            logger.info({ fileKey, comment_id }, "Deleting comment");
+            const api = await getFigmaAPI();
+            await api.deleteComment(fileKey, comment_id);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            deleted_comment_id: comment_id,
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error({ error }, "Failed to delete comment");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: "delete_comment_failed",
+                            message: `Cannot delete comment. ${message}`,
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=comment-tools.js.map

package/dist/core/comment-tools.js.map

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

package/dist/core/config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Configuration management for Figma Console MCP server
+ */
+import type { ServerConfig } from './types/index.js';
+/**
+ * Load configuration from file or use defaults
+ */
+export declare function loadConfig(): ServerConfig;
+/**
+ * Validate configuration
+ */
+export declare function validateConfig(config: ServerConfig): void;
+/**
+ * Get configuration with validation
+ */
+export declare function getConfig(): ServerConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAiErD;;GAEG;AACH,wBAAgB,UAAU,IAAI,YAAY,CAqBzC;AA2BD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAkCzD;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAIxC"}

package/dist/core/config.js

@@ -0,0 +1,154 @@
+/**
+ * Configuration management for Figma Console MCP server
+ */
+import { readFileSync, existsSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+/**
+ * Auto-detect server mode based on environment
+ */
+function detectMode() {
+    // If running in Workers environment, return cloudflare
+    if (typeof globalThis !== 'undefined' && 'caches' in globalThis) {
+        return 'cloudflare';
+    }
+    // Explicit env var override
+    const modeEnv = process.env.FIGMA_MCP_MODE?.toLowerCase();
+    if (modeEnv === 'local' || modeEnv === 'cloudflare') {
+        return modeEnv;
+    }
+    // Default to local for Node.js environments
+    return 'local';
+}
+/**
+ * Default configuration values
+ */
+const DEFAULT_CONFIG = {
+    mode: detectMode(),
+    browser: {
+        headless: false,
+        args: [
+            '--disable-blink-features=AutomationControlled',
+            '--disable-dev-shm-usage',
+            '--no-sandbox', // Note: Only use in trusted environments
+        ],
+    },
+    console: {
+        bufferSize: 1000,
+        filterLevels: ['log', 'info', 'warn', 'error', 'debug'],
+        truncation: {
+            maxStringLength: 500,
+            maxArrayLength: 10,
+            maxObjectDepth: 3,
+            removeDuplicates: true,
+        },
+    },
+    screenshots: {
+        defaultFormat: 'png',
+        quality: 90,
+        storePath: join(process.env.TMPDIR || '/tmp', 'figma-console-mcp', 'screenshots'),
+    },
+};
+/**
+ * Possible config file locations (checked in order)
+ */
+const CONFIG_PATHS = [
+    // Environment variable override
+    process.env.FIGMA_CONSOLE_CONFIG,
+    // Project-local config
+    join(process.cwd(), '.figma-console-mcp.json'),
+    join(process.cwd(), 'figma-console-mcp.json'),
+    // User home config
+    join(homedir(), '.config', 'figma-console-mcp', 'config.json'),
+    join(homedir(), '.figma-console-mcp.json'),
+].filter((path) => path !== undefined);
+/**
+ * Load configuration from file or use defaults
+ */
+export function loadConfig() {
+    // Try to load from config file
+    for (const configPath of CONFIG_PATHS) {
+        if (existsSync(configPath)) {
+            try {
+                const fileContent = readFileSync(configPath, 'utf-8');
+                const userConfig = JSON.parse(fileContent);
+                // Deep merge with defaults
+                const config = mergeConfig(DEFAULT_CONFIG, userConfig);
+                return config;
+            }
+            catch (error) {
+                console.error(`Failed to load config from ${configPath}:`, error);
+                // Continue to next config path
+            }
+        }
+    }
+    // No config file found, use defaults
+    return DEFAULT_CONFIG;
+}
+/**
+ * Deep merge two configuration objects
+ */
+function mergeConfig(defaults, overrides) {
+    return {
+        mode: overrides.mode || defaults.mode,
+        browser: {
+            ...defaults.browser,
+            ...(overrides.browser || {}),
+        },
+        console: {
+            ...defaults.console,
+            ...(overrides.console || {}),
+            truncation: {
+                ...defaults.console.truncation,
+                ...(overrides.console?.truncation || {}),
+            },
+        },
+        screenshots: {
+            ...defaults.screenshots,
+            ...(overrides.screenshots || {}),
+        },
+    };
+}
+/**
+ * Validate configuration
+ */
+export function validateConfig(config) {
+    // Validate browser config
+    if (!Array.isArray(config.browser.args)) {
+        throw new Error('browser.args must be an array');
+    }
+    // Validate console config
+    if (config.console.bufferSize <= 0) {
+        throw new Error('console.bufferSize must be positive');
+    }
+    if (!Array.isArray(config.console.filterLevels)) {
+        throw new Error('console.filterLevels must be an array');
+    }
+    // Validate truncation config
+    const { truncation } = config.console;
+    if (truncation.maxStringLength <= 0) {
+        throw new Error('console.truncation.maxStringLength must be positive');
+    }
+    if (truncation.maxArrayLength <= 0) {
+        throw new Error('console.truncation.maxArrayLength must be positive');
+    }
+    if (truncation.maxObjectDepth <= 0) {
+        throw new Error('console.truncation.maxObjectDepth must be positive');
+    }
+    // Validate screenshot config
+    if (!['png', 'jpeg'].includes(config.screenshots.defaultFormat)) {
+        throw new Error('screenshots.defaultFormat must be "png" or "jpeg"');
+    }
+    if (config.screenshots.quality < 0 || config.screenshots.quality > 100) {
+        throw new Error('screenshots.quality must be between 0 and 100');
+    }
+}
+/**
+ * Get configuration with validation
+ */
+export function getConfig() {
+    const config = loadConfig();
+    validateConfig(config);
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/console-monitor.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Console Monitor
+ * Captures and manages console logs from Figma plugins
+ * Monitors both main page console AND Web Worker consoles (where Figma plugins run)
+ */
+import type { ConsoleLogEntry, ConsoleConfig } from './types/index.js';
+/**
+ * Console Monitor
+ * Listens to page console events and maintains a circular buffer of logs
+ * Also monitors Web Workers to capture Figma plugin console logs
+ */
+export declare class ConsoleMonitor {
+    private logs;
+    private config;
+    private isMonitoring;
+    private page;
+    private workers;
+    private lastUrl;
+    constructor(config: ConsoleConfig);
+    /**
+     * Start monitoring console logs on a page.
+     * Accepts the @cloudflare/puppeteer Page type (cloud mode only).
+     */
+    startMonitoring(page: any): Promise<void>;
+    /**
+     * Attach console listeners to a Web Worker
+     * This captures Figma plugin console logs
+     */
+    private attachWorkerListeners;
+    /**
+     * Process console message from Puppeteer
+     * @param msg - Console message from page or worker
+     * @param context - Where the message came from ('page' or 'worker')
+     * @param workerUrl - URL of the worker (if context is 'worker')
+     */
+    private processConsoleMessage;
+    /**
+     * Determine if log is from plugin or Figma based on URL
+     */
+    private determineSource;
+    /**
+     * Add log to circular buffer
+     */
+    private addLog;
+    /**
+     * Truncate string to max length
+     */
+    private truncateString;
+    /**
+     * Truncate value (string, array, object) intelligently
+     * Based on AgentDesk pattern to prevent context overflow
+     */
+    private truncateValue;
+    /**
+     * Get logs with optional filtering
+     */
+    getLogs(options?: {
+        count?: number;
+        level?: ConsoleLogEntry['level'] | 'all';
+        since?: number;
+    }): ConsoleLogEntry[];
+    /**
+     * Clear log buffer
+     */
+    clear(): number;
+    /**
+     * Stop monitoring
+     */
+    stopMonitoring(): void;
+    /**
+     * Get monitoring status
+     */
+    getStatus(): {
+        isMonitoring: boolean;
+        logCount: number;
+        bufferSize: number;
+        workerCount: number;
+        oldestTimestamp: number;
+        newestTimestamp: number;
+    };
+}
+//# sourceMappingURL=console-monitor.d.ts.map

package/dist/core/console-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-monitor.d.ts","sourceRoot":"","sources":["../../src/core/console-monitor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAOvE;;;;GAIG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,IAAI,CAAyB;IACrC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAAc;gBAEjB,MAAM,EAAE,aAAa;IAIjC;;;OAGG;IACG,eAAe,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IA6L/C;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAgC7B;;;;;OAKG;YACW,qBAAqB;IAqEnC;;OAEG;IACH,OAAO,CAAC,eAAe;IA4BvB;;OAEG;IACH,OAAO,CAAC,MAAM;IAWd;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAqDrB;;OAEG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;QACzC,KAAK,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,eAAe,EAAE;IAqBrB;;OAEG;IACH,KAAK,IAAI,MAAM;IAOf;;OAEG;IACH,cAAc,IAAI,IAAI;IAYtB;;OAEG;IACH,SAAS;;;;;;;;CAUT"}