attalla1/photopea-mcp-server

Добавляет недеструктивный слой сплошной заливки на весь холст. В отличие от fill_selection, он создаёт отдельный корректирующий слой — его можно включить/выключить, перекрасить или удалить, не трогая остальные. Чтобы изменить прозрачность или режим наложения, используй set_layer_properties.

Применяет заливку линейным градиентом к слою, заменяя его текущее пиксельное содержимое. Целевой слой уже должен существовать — используйте add_layer, чтобы сначала создать его. Цвета равномерно распределяются по градиенту.

Добавляет новый пустой слой в активный документ. Новый слой становится активным. Используйте это перед операциями, которые рисуют на слое, такими как fill_selection или add_gradient.

Добавляет слой векторной фигуры (прямоугольник или эллипс) в активный документ. Слой фигуры становится активным слоем. Фигуры неразрушающие — их можно изменять в размере с помощью transform_layer без потери качества.

Добавляет новый текстовый слой в активный документ в указанную позицию. Текстовый слой становится активным слоем. Используйте paragraphBounds для создания текстового блока с переносом слов или опустите для точечного текста. Используйте load_font для добавления пользовательских шрифтов и list_fonts для поиска доступных имён шрифтов.

Применяет деструктивную корректировку изображения к пиксельным данным активного слоя. Сначала используйте select_layer для выбора конкретного слоя. Изменяет пиксели напрямую — используйте undo для отмены при необходимости.

Применяет разрушительный эффект фильтра к пиксельным данным активного слоя. Сначала необходимо вызвать select_layer для выбора конкретного слоя. Изменяет пиксели напрямую — используйте undo для отмены, если потребуется.

Снимает текущее выделение в активном документе, убирая бегущих муравьёв. Не изменяет пиксельные данные. Используйте после завершения fill_selection или других операций, основанных на выделении.

Закрывает активный документ. Установите save в true, чтобы сохранить изменения перед закрытием. Несохранённые изменения отбрасываются, если save имеет значение false. Следующий открытый документ становится активным, если таковой имеется.

Создает новый пустой документ и делает его активным. Обычно это первый шаг в рабочем процессе. Документ открывается со слоем Background. Чтобы редактировать существующее изображение, используйте open_file.

Навсегда удаляет слой из активного документа по имени или индексу. Следующий слой в стеке становится активным после удаления. Используйте get_layers, чтобы увидеть доступные слои перед удалением.

Создаёт копию слоя в активном документе. Дубликат становится активным слоем и размещается над оригиналом. Используйте newName, чтобы отличить копию от оригинала.

Изменяет содержимое или стиль существующего текстового слоя. Изменяются только указанные свойства - опустите параметры, чтобы сохранить их текущие значения. Используйте get_layers для поиска названий текстовых слоев, если необходимо.

Экспортирует активный документ в файл и сохраняет его в локальной файловой системе. Весь документ уплощается и экспортируется в выбранном формате. Используйте create_document или open_file, чтобы настроить документ перед экспортом.

Заполняет текущее выделение сплошным цветом на активном слое. Требуется активное выделение — используйте make_selection, чтобы сначала создать его. Напрямую изменяет пиксельные данные на активном слое. После используйте clear_selection, чтобы снять выделение.

Получает метаданные активного документа: имя, ширину, высоту, разрешение (DPI), количество слоёв и цветовой режим. Возвращает JSON. Используйте для проверки размеров документа перед позиционированием слоёв или созданием выделений.

Получает полное дерево слоёв активного документа в формате JSON. Возвращает массив объектов слоёв со свойствами name, type, index, visible, opacity, blendMode и bounds. Группы содержат вложенные массивы children. Используйте это, чтобы узнать имена и индексы слоёв для других операций со слоями.

Объединяет несколько слоев в группу слоев (папку). Слои указываются по имени — используйте get_layers, чтобы найти имена слоев. Сгруппированные слои можно позже разгруппировать с помощью ungroup_layers.

Выводит список доступных шрифтов в Photopea. Возвращает PostScript-имена шрифтов, которые можно использовать с add_text и edit_text.

Загружает пользовательский шрифт из URL (TTF, OTF или WOFF2) в Photopea. Шрифт становится доступным для add_text и edit_text. Используйте list_fonts, чтобы найти имя PostScript после загрузки.

Создаёт область выделения пикселей в активном документе. После создания выделения используйте fill_selection для заполнения цветом или clear_selection для отмены выделения. Используйте тип 'all' для выбора всего холста или 'rect'/'ellipse' с границами для конкретной области.

Изменяет текущее активное выделение. Требует существующее выделение, созданное make_selection. Для expand, contract и feather параметр amount задаёт пиксели. Invert меняет местами выделенные и невыделенные области.

Перемещает слой на относительное смещение по x/y в пикселях от его текущей позиции. Положительное x смещает вправо, положительное y — вниз. Используйте get_layers, чтобы проверить текущие границы слоя, или transform_layer для масштабирования и поворота.

Открывает существующий файл изображения в Photopea как новый документ. Поддерживает PSD, PNG, JPG, WebP, SVG и другие распространённые форматы. Открытый файл становится активным документом. Используйте create_document, чтобы начать с чистого холста.

Помещает изображение в активный документ из URL или локального пути. Создаёт новый слой с размещённым изображением как активный слой. Используйте width/height для изменения размера с сохранением соотношения сторон или x/y для позиционирования слоя.

Повторяет одно или несколько ранее отменённых действий в активном документе. Доступно только после использования undo — история redo очищается при выполнении новых действий.

Перемещает слой на новую позицию в стеке слоёв. Используйте 'top' или 'bottom', чтобы переместить в начало или конец стека, или 'above'/'below', чтобы сдвинуть на одну позицию относительно текущего индекса. Используйте get_layers, чтобы увидеть текущий порядок слоёв.

Изменяет размер холста активного документа на новые размеры в пикселях, пересчитывая всё содержимое слоёв, чтобы оно поместилось. Это необратимая операция - все слои масштабируются пропорционально. Используйте отмену (Undo), чтобы вернуть изменения, если нужно.

Выполняет произвольный JavaScript Photopea/ExtendScript в среде Photopea. Используйте для продвинутых операций, не охваченных другими инструментами. Имеет полный доступ к DOM Photopea (app, activeDocument, layers). Используйте с осторожностью — скрипты могут изменить или удалить любые данные документа.

Устанавливает слой как активный по имени или индексу. Многие инструменты (apply_filter, apply_adjustment, fill_selection) работают с активным слоем: используйте это, чтобы сначала выбрать нужный слой. Используйте get_layers, чтобы найти имена и индексы слоёв.

Обновляет одно или несколько свойств слоя. Изменяются только указанные свойства; остальные остаются с текущими значениями. Используйте get_layers для просмотра текущих значений свойств перед изменением.

Масштабирует, поворачивает или отражает слой на месте. Необратимо изменяет данные пикселей слоя. Используйте get_layers, чтобы проверить текущие границы слоя перед преобразованием, и undo, чтобы отменить при необходимости.

Отменяет одно или несколько последних действий в активном документе. Каждый шаг отменяет одну операцию из истории. Используйте после деструктивных операций (apply_filter, apply_adjustment, fill_selection), чтобы отменить изменения.

Распустить группу слоев, переместив все дочерние слои в корень документа. Папка группы удаляется, но её содержимое сохраняется. Используйте get_layers, чтобы найти имена групп.