Photoshop MCP Server

MCP-сервер для Windows, который управляет установленным Photoshop: документы, слои и произвольные скрипты JSX

  • 345 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Широкий доступ

Почему такой уровень

  • Инструмент photoshop_execute_jsx выполняет любой код в вашем Photoshop
  • Агент создает и сохраняет документы, а значит может перезаписать рабочие файлы
Все причины и проверки

loonghao/photoshop-python-api-mcp-server

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/photoshop-mcp-server

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Инструмент photoshop_execute_jsx выполняет любой код в вашем Photoshop
  • Агент создает и сохраняет документы, а значит может перезаписать рабочие файлы

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Photoshop MCP Server соединяет MCP-клиент с установленным на компьютере Adobe Photoshop через Python-библиотеку photoshop-python-api. Агент создает, открывает и сохраняет документы, добавляет текстовые и сплошные слои, читает сведения о сессии, активном документе и выделении. Для остальных задач есть инструмент photoshop_execute_jsx. Он запускает любой код Photoshop JavaScript и возвращает результат с отметкой успеха или текст ошибки. Так агент добирается до каналов, контуров, состояний истории и фильтров. Объекта JSON в движке ExtendScript нет, и сервер подставляет вместо него свою заготовку. Сервер отдает три ресурса: photoshop://info, photoshop://document/info и photoshop://document/layers.

Для кого. Для дизайнеров и разработчиков на Windows, которые хотят поручать агенту рутину в Photoshop: создание макетов, слоев и пакетные операции.

Подходит, если

  • Нужно создать документ и наложить на него несколько текстовых слоев по описанию
  • Агент должен перечислить слои активного документа и их имена
  • Требуется пакетная операция в Photoshop, которой нет среди готовых инструментов, через JSX
  • Хочется узнать размеры и разрешение открытого документа без ручного просмотра

Не подходит, если

  • Вы работаете на macOS или Linux: сервер использует COM-интерфейсы Windows и там не запустится
  • Photoshop не установлен локально: сервер управляет только установленной копией
  • Агенту нельзя позволять выполнять произвольный код в вашем Photoshop
  • Нужна генерация картинок моделью: сервер только правит документы в Photoshop

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

Создай в Photoshop документ 1080 на 1080 и добавь текстовый слой с заголовком «Скидка 20%»

MCP

Транспорт
stdio
Авторизация
не нужна

Переменные окружения

PS_VERSION
Версия Photoshop для подключения, например 2024

Ограничения

Сервер работает только в Windows: он обращается к Photoshop через COM-интерфейсы. Нужны установленный Adobe Photoshop и Python 3.10 или новее. Автор тестировал версии Photoshop от CC2017 до 2024. Движок ExtendScript основан на ECMAScript 3, поэтому стрелочные функции, let и const в скриптах недоступны. Если Photoshop не сообщает размеры документа, ширина и высота приходят нулями с пометкой о недоступных размерах.

Как отключить. Удалите запись photoshop из mcpServers в конфигурации клиента и перезапустите клиент. Пакет удаляется командой `pip uninstall photoshop-mcp-server`.

Частые вопросы

Как поставить Photoshop MCP Server в Claude Desktop?

Установите пакет командой pip install photoshop-mcp-server либо используйте uvx. В конфигурацию mcpServers добавьте запись photoshop с командой uvx, аргументами --python 3.10 и photoshop-mcp-server и переменной PS_VERSION.

Почему скрипт JSX со стрелочной функцией падает с ошибкой?

Движок ExtendScript в Photoshop понимает только синтаксис ECMAScript 3. Пишите функции через function и объявляйте переменные через var.

Что делает photoshop_execute_jsx?

Запускает любой переданный код Photoshop JavaScript. При успехе возвращает результат, а при ошибке внутри Photoshop или недоступном Photoshop возвращает отметку неудачи и текст ошибки.

Какие версии Photoshop поддерживаются?

Нужную версию указывают в переменной PS_VERSION, например 2024 или 2023. Автор проверял версии от CC2017 до 2024.

Какие ресурсы отдает сервер?

Три: photoshop://info со сведениями о программе, photoshop://document/info об активном документе и photoshop://document/layers со слоями.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

MCP-сервер для Adobe Photoshop: удаление фона, ретушь, экспорт для соцсетей и пакетные операции голосом

MCP-серверРасширенный доступ759Звезды репозитория

MCP-сервер для Adobe After Effects: создание композиций, слоев, ключевых кадров и выражений через агента

MCP-серверРасширенный доступ811Звезды репозитория

Локальный MCP-сервер для правки и разбора изображений: агент обрезает кадры, находит объекты и читает текст с фото

MCP-серверРасширенный доступ334Звезды репозитория

MCP-сервер дает агенту 123 инструмента Aseprite для пиксель-арта и анимации и снимки, по которым он проверяет рисунок

MCP-серверШирокий доступ845Звезды репозитория

MCP-сервер управляет локальными проектами Adobe Premiere Pro из Claude, Codex и других MCP-клиентов

MCP-серверРасширенный доступ775Звезды репозитория

Локальный MCP-сервер дает Claude, Cursor и Codex читать проект Premiere Pro, править таймлайн и экспортировать результат

MCP-серверШирокий доступ453Звезды репозитория

Коротко о README

Пакет опубликован в PyPI, ставить его можно через pip или uv. Одна и та же конфигурация подходит для Claude Desktop, Windsurf и Cline, а к инструменту JSX приложены примеры скриптов.

Бейдж для README

Сообщить о проблеме

Foxx AIPhotoshop MCP Server
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.