Cursor Talk to Figma MCP

Instructions

Implementation Reference

• src/cursor_mcp_plugin/code.js:714-766 (handler)

  Core Figma plugin implementation that sets the stroke color and optional weight on the specified node by updating node.strokes and node.strokeWeight.

  async function setStrokeColor(params) {
    const {
      nodeId,
      color: { r, g, b, a },
      weight = 1,
    } = params || {};
  
    if (!nodeId) {
      throw new Error("Missing nodeId parameter");
    }
  
    const node = await figma.getNodeByIdAsync(nodeId);
    if (!node) {
      throw new Error(`Node not found with ID: ${nodeId}`);
    }
  
    if (!("strokes" in node)) {
      throw new Error(`Node does not support strokes: ${nodeId}`);
    }
  
    // Create RGBA color
    const rgbColor = {
      r: r !== undefined ? r : 0,
      g: g !== undefined ? g : 0,
      b: b !== undefined ? b : 0,
      a: a !== undefined ? a : 1,
    };
  
    // Set stroke
    const paintStyle = {
      type: "SOLID",
      color: {
        r: rgbColor.r,
        g: rgbColor.g,
        b: rgbColor.b,
      },
      opacity: rgbColor.a,
    };
  
    node.strokes = [paintStyle];
  
    // Set stroke weight if available
    if ("strokeWeight" in node) {
      node.strokeWeight = weight;
    }
  
    return {
      id: node.id,
      name: node.name,
      strokes: node.strokes,
      strokeWeight: "strokeWeight" in node ? node.strokeWeight : undefined,
    };
  }

• src/talk_to_figma_mcp/server.ts:616-656 (registration)

  MCP server tool registration for set_stroke_color, including schema validation with Zod and handler that proxies the command to the Figma plugin via WebSocket.

  server.tool(
    "set_stroke_color",
    "Set the stroke color of a node in Figma",
    {
      nodeId: z.string().describe("The ID of the node to modify"),
      r: z.number().min(0).max(1).describe("Red component (0-1)"),
      g: z.number().min(0).max(1).describe("Green component (0-1)"),
      b: z.number().min(0).max(1).describe("Blue component (0-1)"),
      a: z.number().min(0).max(1).optional().describe("Alpha component (0-1)"),
      weight: z.number().positive().optional().describe("Stroke weight"),
    },
    async ({ nodeId, r, g, b, a, weight }) => {
      try {
        const result = await sendCommandToFigma("set_stroke_color", {
          nodeId,
          color: { r, g, b, a: a || 1 },
          weight: weight || 1,
        });
        const typedResult = result as { name: string };
        return {
          content: [
            {
              type: "text",
              text: `Set stroke color of node "${typedResult.name
                }" to RGBA(${r}, ${g}, ${b}, ${a || 1}) with weight ${weight || 1}`,
            },
          ],
        };
      } catch (error) {
        return {
          content: [
            {
              type: "text",
              text: `Error setting stroke color: ${error instanceof Error ? error.message : String(error)
                }`,
            },
          ],
        };
      }
    }
  );

• src/cursor_mcp_plugin/code.js:131-132 (handler)

  Dispatch handler in Figma plugin's main command switch that routes set_stroke_color calls to the setStrokeColor implementation.

  case "set_stroke_color":
    return await setStrokeColor(params);

• src/talk_to_figma_mcp/server.ts:619-625 (schema)

  Zod schema for input validation of set_stroke_color tool parameters.

  {
    nodeId: z.string().describe("The ID of the node to modify"),
    r: z.number().min(0).max(1).describe("Red component (0-1)"),
    g: z.number().min(0).max(1).describe("Green component (0-1)"),
    b: z.number().min(0).max(1).describe("Blue component (0-1)"),
    a: z.number().min(0).max(1).optional().describe("Alpha component (0-1)"),
    weight: z.number().positive().optional().describe("Stroke weight"),