@muloka/figma-console-mcp 0.5.0 → 0.5.2

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

@@ -1,292 +0,0 @@
-/**
- * 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,
-            };
-        }
-    });
-}

package/dist/cloudflare/core/config.js

@@ -1,153 +0,0 @@
-/**
- * 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;
-}