Figma Agent Kit
  • Русский

      • Инструменты MCP

      Русский | 简体中文 | English

      Инструменты, предоставляемые figma-agent-mcp (всего 37). Если не указано иное, вызовы перенаправляются открытому плагину Figma через мост.

      Соглашения

      СоглашениеДетали
      fileKeyНеобязателен почти для всех инструментов — выбирает подключённый файл
      Плоский формат или propertiesМногие инструменты записи принимают плоские поля (name, x, …) или вложенный объект properties (объединяется на стороне плагина)
      Резервный вариант выделенияЕсли nodeIds не указан для скриншота / метаданных / контекста дизайна / масштаба, плагин использует текущее выделение
      MotionТребуется сборка Figma с Motion API; иначе возвращается понятная ошибка возможности

      Meta (локально в MCP)

      ИнструментОписание
      list_filesСписок файлов Figma, сейчас подключённых к мосту (локально в leader / у follower через /files)
      save_screenshotsЭкспортирует узлы на диск. Для PNG по умолчанию используется сжатие в стиле TinyPNG (compress=true). По умолчанию scale — 2; используйте scale=3 для срезов, соответствующих экспорту UI плагина. Поддерживает format: PNG / SVG / JPG / PDF, необязательные clip, path

      Чтение

      ИнструментОписание
      get_documentОбзор дерева текущей страницы (depth необязателен, 0–20)
      get_selectionТекущее выделение
      get_nodeСериализует узлы по id (nodeIds обязателен, depth необязателен)
      get_stylesЛокальные стили paint / text / effect
      get_metadataОблегчённые id / имя / тип / размер
      get_design_contextСериализованные узлы для контекста агента
      get_variable_defsЛокальные коллекции переменных и переменные
      get_screenshotРастровый/векторный экспорт; протокол использует необработанные байты (MsgPack bin), результат агента — base64. По умолчанию format=PNG, scale=2. Без сжатия — для сжатых срезов предпочтите save_screenshots

      Запись / изменение

      ИнструментОписание
      set_node_visibilityПоказать / скрыть (visible)
      set_text_contentЗадать текстовые символы (text)
      set_text_propertiesРазмер / семейство / стиль шрифта, выравнивание / интервалы
      set_node_propertiesИмя, позиция, размер, непрозрачность, поворот
      set_solid_fillСплошная заливка (color: {r,g,b,a?}, 0–1 или 0–255)
      set_gradient_fillГрадиентная заливка (gradientStops, необязательный gradientType)
      set_effectsТени / размытия (массив effects)
      set_stroke_propertiesТолщина / выравнивание / цвет обводки
      set_auto_layoutAuto-layout на фреймах
      create_frameСоздать фрейм
      create_textСоздать текстовый узел
      create_shapeСоздать RECTANGLE / ELLIPSE / LINE / POLYGON / STAR
      create_imageПрямоугольник с заливкой изображения из base64 imageData
      duplicate_nodesДублировать
      reparent_nodesПереместить в иерархии (parentId, необязательный index)
      group_nodesСгруппировать
      ungroup_nodeРазгруппировать
      set_selectionИзменить выделение
      scroll_and_zoom_into_viewСфокусировать область просмотра
      delete_nodesУдалить узлы

      Motion (бета-версия Figma Motion API)

      ИнструментОписание
      get_motion_stylesСписок доступных стилей / пресетов анимации
      get_node_motionЧитает стили анимации, ключевые кадры, таймлайны
      apply_animation_styleПрименяет стиль (styleId, необязательный animationStyleData) — для встроенных пресетов используйте animationStyleData.type: "FIGMA"
      remove_animation_styleУдаляет один стиль или все (animationStyleId необязателен)
      apply_manual_keyframe_trackЗаписывает ручную дорожку ключевых кадров (field, track)
      remove_manual_keyframe_trackУдаляет ручную дорожку ключевых кадров (field)
      set_timeline_durationЗадаёт продолжительность таймлайна (timelineId, duration)

      Пример потока агента

      1. list_files
      2. get_selection / get_node
      3. get_screenshot для быстрого предпросмотра
      4. save_screenshots с scale: 3, compress: true для срезов поставки
      5. set_text_content / set_node_properties (или инструменты Motion) для применения правок

      Источник схем

      Авторитетные схемы Zod находятся в packages/figma-agent-mcp/src/schema.ts. Регистрация инструментов — в tools.ts.