Skip to content

Releases

v1.6.0

Choose a tag to compare

@Alkaness Alkaness released this 24 Sep 19:02

The plugin changed in this release. Close it in Figma and run it again from Menu > Plugins > Development; Figma then loads the new code.js.

Added

  • create_node_tree and update_nodes write in the format that get_node_info reads. An agent that had read a design could not write it back. No tool set FILL or HUG sizing, absolute positioning, constraints, stroke alignment or mixed-style text. create_text used only Inter. Colors were read as hex but written as 0-1 floats in three different shapes. Rebuilding one card took about 22 sequential calls, and the result was still wrong.

    1. create_node_tree builds a node and its whole subtree in one call and returns the ID of every node it created. A get_node_info result, edited or not, is a valid input.
    2. update_nodes changes the given properties of several existing nodes in one call.
    3. Both accept hex colors and resolve fontWeight to each family's own style name (Inter "Semi Bold", Poppins "SemiBold").
    4. Both validate the whole spec before changing anything and name the path of each error.
    5. Both report every property that was not applied as a warning. A failed build removes what it created.
  • locked in the node format. get_node_info reports locked: true, and create_node_tree and update_nodes set it. rectangleCornerRadii in update_nodes takes null for a corner to keep, so one call can change some corners only. With these, update_nodes covers set_node_properties, set_corner_radius and set_font_weight.

  • get_visual_snapshot takes region, a part of the node in px from the top-left of its bounding box. A tall page was scaled to fit 2000 px, so a 1440 x 9879 px section rendered at 0.2x; a region renders at the requested scale. When a snapshot is scaled down, the result suggests a region. The plugin exports the region through a temporary slice, which it removes.

  • get_styled_text_segments takes properties, up to 10 style properties in one call. A segment ends where any of them changes. property still takes one.

  • get_css takes maxNodes (default 200, up to 1000) for recursive=true.

Fixed

  • create_node_tree was tested in Figma, and these problems were fixed. The rebuilt test nodes include a 125-node section and a 122-node rotated group.

    1. An absolute child with a RIGHT or BOTTOM constraint moved when its HUG parent grew while later siblings were added: a badge placed at 170, 150 landed at 330, 300. Positions, constraints and rotation are now applied after the whole tree is built.
    2. A rotated GROUP was rotated twice, because its children's rotation already includes the group's. A group is now built unrotated and placed at its children's box. In the 122-node group, rotated -147.7 degrees, every node lands within 0.01 px of the original.
    3. A clone inside a rotated group kept a rotation relative to the group. Clones and instances now always get their rotation, 0 included.
    4. Figma's defaults for new nodes differed from what an omitted field means in get_node_info output. New auto-layout frames included strokes in the layout, new drop shadows were shown behind the node, and the counter axis of a new auto-layout frame stayed fixed. These values are now set explicitly. An omitted sizing mode hugs, unless layoutSizing* or a width or height says otherwise.
    5. Clones were resized to the size they already had, which turned a 0 px wide vector into 0.01 px.
    6. When Figma listed no fonts, text failed with font family "Inter" is not available in Figma. The error now says that Figma lists no fonts (seen with figma-linux), and an unknown family names up to 5 similarly spelled families.
  • create_node_tree and update_nodes were tested with text in Figma, and these problems were fixed. The tests rebuilt a 738-node section with 64 text nodes and 69 nodes with effects, and ran 144 combinations of text sizing modes.

    1. Node fills were applied after the text runs and replaced their colors: words set in orange in the original came out in the text's base color. Node properties are now applied before the text.
    2. update_nodes set every run to one font when only fontFamily changed, so semibold words became regular. A fontWeight in a style or run without fontFamily failed. The server now reads the node's fonts with get_node_info, as set_font_weight does. A family alone keeps each run's weight and slant, and a weight alone keeps each run's family.
    3. NOISE, TEXTURE and GLASS effects were skipped with a warning. They are now passed through, and get_node_info reads their settings from the plugin, because Figma's JSON export gives GLASS as its type alone. All 69 effects of the section were rebuilt unchanged.
  • Image contrast in get_node_info output was 0.3 times the value Figma uses. The REST format scales contrast by 0.3 (0.9 exports as 0.27); the other six filters are unscaled. The value is now converted, so it matches set_image_filters and create_node_tree.

  • set_font_weight failed for families that spell style names differently from Inter. It mapped weights to Inter's names, so 600 asked Poppins, Montserrat or Open Sans for "Semi Bold", while they have "SemiBold". It now resolves the weight against the node's own family, the way create_node_tree does, and keeps italic. When the family has no style of that weight, it uses the closest one and names it. Through batch_operations, which bypasses the server, the plugin matches Inter's name to the family's style while ignoring spaces and case.

  • rest_get_file reported rotation in radians with the opposite sign. It now reports degrees, as get_node_info does.

  • rotate_node described its angle as clockwise. Figma's rotation is counterclockwise.

  • get_node_info, get_nodes_info and rest_get_file no longer discard layout and styling. The node filter kept 10 properties and dropped the rest. Agents therefore had to infer auto-layout from coordinates, rendered hidden layers, merged mixed-style text into one style, and lost stroke weights, per-corner radii, effects, opacity and clipping. The tree now includes:

    1. Auto-layout and child sizing: layoutMode, padding, itemSpacing, alignment, sizing modes, layoutSizingHorizontal/layoutSizingVertical, layoutPositioning and constraints.
    2. visible: false stubs for hidden layers.
    3. Clipping, opacity and blend mode.
    4. Stroke weight, alignment and dashes, and rectangleCornerRadii.
    5. Effects.
    6. The full text style, with textRuns for mixed-style text.
    7. imageRef on image fills.
    8. parentOffset, the position relative to the parent's bounding box.

    Values equal to Figma's defaults are omitted, and lengths are rounded to 2 decimals. The change is in the MCP server only; the plugin does not need to be re-imported.

  • get_node_info on a vector node returned an error, because vector nodes were removed from the tree. They are now returned like other nodes.

  • create_text reported success when its font failed to load, and left an Inter Regular node at the default size. It now returns the error and creates nothing.

  • create_rectangle, create_frame and create_text declared parentId optional, although the relay rejects creation without it. The schemas now require it.

Deprecated

  • 24 tools that create_node_tree and update_nodes cover. These are the single-property setters (set_fill_color, set_stroke_color, set_gradient, set_effects, set_auto_layout, move_node, resize_node, rename_node, set_node_properties, set_corner_radius, set_font_name, set_font_weight, set_font_size, set_line_height, set_paragraph_spacing, set_text_align, set_text_case, set_text_decoration), the text content setters (set_text_content, set_multiple_text_contents) and create_frame, create_rectangle, create_ellipse and create_text. They still work. Each description now begins with "Deprecated: use ..." and names the replacement field, and COMMANDS.md, section 3 lists the mapping. Removing them in a later release shrinks the tools/list response from 104 tools and 90,599 characters to 80 tools and 67,035 characters, 26% less (measured without a REST token). Three tools are kept: rotate_node (a relative angle), set_letter_spacing (percent) and set_image_filters (works without the image hash).
  • The design_strategy, text_replacement_strategy and audit-accessibility prompts, and the README examples, no longer name deprecated tools.

Changed

  • compare_to_figma reports where the render differs. It compared on a grid of 120 cells across (12 design px per cell at 1440 px) and called 80% SSIM or more a close match. On a 1440 x 765 px section, moving the headline by 8 px still scored 96.7%, and a font size 2 px larger scored 90.6%, so both were "close". Now:
    1. Grid cells cover 4 design px (120 to 600 cells across).
    2. A cell differs when its structural mismatch exceeds 0.5 or a color channel of its mean differs by more than 60 of 255. The 1x snapshot of the unchanged section differs from its 2x snapshot by 31 at most. Moving a text or a 54 px circle by 2 px, and changing a color, a font or a font size, each exceeded 60.
    3. Up to 5 hot spots, clusters of differing cells, are listed as boxes in design px from the node's top-left and in canvas coordinates, largest first, with the differing area in percent.
    4. "Close match" now also requires no hot spots. The diff heatmap shows color differences as well as structural ones, and is at most about 2400 px on its longer side.
  • get_css with recursive=true skips hidden layers (it included them, although they are not rendered), indents each block by its depth below the requested node, and gives the text of text nodes. The number of skipped hidden layers is reported.
  • The export-to-tailwind and read_design_strategy prompts and the get_node_info, `ge...
Read more

v1.5.0

Choose a tag to compare

@Alkaness Alkaness released this 23 Sep 18:55

First release of the standalone repository Alkaness/talk-to-figma-mcp.

Security

  • Relay binds to 127.0.0.1 by default: Bun's default bind address is every interface, so the unauthenticated relay was reachable from the local network and any host on it could read or modify the open Figma file (the origin allowlist only stops browsers). FIGMA_SOCKET_HOST=0.0.0.0 restores network access and is now required for Windows + WSL; the Docker image sets it inside the container. The MCP server now connects to ws://127.0.0.1 to match.

Changed

  • New npm package @alkaness/talk-to-figma-mcp. The commands are now npx @alkaness/talk-to-figma-mcp (launcher) and npx -p @alkaness/talk-to-figma-mcp@latest talk-to-figma-mcp-server (MCP server). The package claude-talk-to-figma-mcp belongs to the original project and does not contain these changes; client entries that use it must be replaced (see INSTALLATION.md, section 4).
  • Renamed to Talk to Figma: the Claude Desktop extension (talk-to-figma-mcp.dxt, display name "Talk to Figma"), the Figma plugin name (its ID is unchanged, so an existing import keeps working), the messages shown to the agent, and the documentation. The suggested client configuration key is TalkToFigma and the MCP server reports itself as TalkToFigmaMCP.
  • Author is Alkaness; the original authors are listed as contributors in package.json.
  • Documentation rewritten in a formal style: numbered sections, exact figures, no emojis. COMMANDS.md is regenerated from the source and now covers all 107 tools (29 were missing), 5 prompts and 2 resources. readme.md is renamed to README.md, and TESTING.md is merged into CONTRIBUTING.md.
  • Docker instructions publish the relay on 127.0.0.1:3055 only.

Fixed

  • Release workflow: dxt pack names its output after the checkout folder, which no longer matched the .dxt file the workflow uploaded, so releases received no asset. The package is now written to the fixed name talk-to-figma-mcp.dxt with the pinned @anthropic-ai/dxt devDependency, and the artifact upload fails when the file is missing.
  • configure-claude produced an invalid bin name for a scoped package and suggested a relay command that requires Bun; it now uses talk-to-figma-mcp-server and the launcher.

Removed

  • context/ (the original author's development notes), images/ (banner and unreferenced screenshots), prompts/ (unlinked UX/UI prompt files), smithery.yaml and TESTING.md.
  • The icon field in the DXT manifest.json, which pointed at the removed banner. Claude Desktop shows its default extension icon.

Install

  • Claude Desktop: download talk-to-figma-mcp.dxt below and open it.
  • Other clients: see INSTALLATION.md.