PsMCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
PsMCP — MCP-сервер для Adobe Photoshop
Управление Photoshop из любого MCP-клиента (opencode, Claude Desktop, Cursor, ...).
Ничего не устанавливается внутрь Photoshop: сервер говорит с ним по COM
(Photoshop.Application.DoJavaScript), а если Photoshop не запущен — COM запускает его сам.
Что умеет
Инструмент | Что делает |
| Выполняет любой ExtendScript в Photoshop и возвращает результат в JSON. Это вся объектная модель: документы, слои, текст, маски, выделения, фильтры, каналы, смарт-объекты, сохранение и экспорт. Не зависает: при модальном диалоге возвращает понятную ошибку. |
| Показывает модальные диалоги Photoshop и нажимает в них кнопку ( |
| Скриншот окна Photoshop — весь интерфейс: панели, слои, документ. |
| Предпросмотр: активный документ рендерится в PNG (с учётом слоёв и масок), сам документ не меняется. |
Related MCP server: Photoshop MCP Server
Требования
Windows, Adobe Photoshop 2022+ (проверено на 2024, 25.12).
Python 3.10+ с пакетами
mcp,pywin32,pillow.Photoshop должен быть зарегистрирован в COM с
/Automation— обычная установка это делает (ключHKLM\SOFTWARE\Classes\CLSID\{DD6CF2ED-4840-40A1-A393-B1F74F54D59A}\LocalServer32).
Установка
cd F:\PsMCP
py -3.11 -m pip install -r requirements.txtПроверка на живом Photoshop (запускает его, если закрыт):
py -3.11 tests/smoke.py # eval, фильтры, сохранение, предпросмотр, скриншот
py -3.11 tests/dialogs.py # модальный диалог не вешает сервер
py -3.11 tests/stdio.py # протокол MCP: handshake, tools/list, tools/callПодключение к MCP-клиенту
opencode / любой клиент с форматом mcp:
"photoshop": {
"type": "local",
"command": ["C:/Program Files/Python311/python.exe", "F:/PsMCP/server.py"],
"enabled": true
}Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"photoshop": {
"command": "C:/Program Files/Python311/python.exe",
"args": ["F:/PsMCP/server.py"]
}
}
}Примеры
// что открыто
({docs: app.documents.length, active: app.activeDocument.name})
// новый документ
var d = app.documents.add(1920, 1080, 72, "Banner", NewDocumentMode.RGB, DocumentFill.WHITE);
d.layers.length
// текст
var t = app.activeDocument.artLayers.add();
t.kind = LayerKind.TEXT;
t.textItem.contents = "Привет";
t.textItem.size = 120;
// фильтр по тексту: сначала растеризовать, иначе Photoshop спросит разрешение
t.rasterize(RasterizeType.ENTIRELAYER);
t.applyGaussianBlur(2.5);
// сохранить
app.activeDocument.saveAs(new File("C:/work/banner.psd"), new PhotoshopSaveOptions(), false, Extension.LOWERCASE);Особенности ExtendScript, которые полезно помнить:
это ES3 — нет
JSON,let/const, стрелок,Array.prototype.map/forEach;коллекции 0-based:
app.documents[0],doc.layers[0](верхний слой), аitemIndexу слоя — 1-based;UnitValueпечатается как{}— берите.valueили.as("px");операции над текстом, которые не умеет текстовый слой (фильтры, часть трансформаций), вызывают диалог «растрировать или преобразовать в смарт-объект» — растеризуйте заранее или отвечайте на диалог через
ps_dialogs.
Диалоги и зависания
Photoshop показывает модальные диалоги прямо посреди скрипта. Сервер устроен так, что это не вешает MCP:
скрипты идут через один COM-поток, поэтому занятый Photoshop возвращает ошибку, а не бесконечное ожидание;
если Photoshop отказал из-за модального окна, ошибка сразу называет диалог и его кнопки;
ps_dialogsнаходит такие окна (в том числе собственный класс PhotoshopPSDialogBox) и жмёт кнопку:ps_dialogs(close="cancel"),ps_dialogs(close="ok"),ps_dialogs(close="Растрировать");у
ps_eval/ps_previewесть параметрtimeout(секунды, по умолчанию 120) — им ограничивается ожидание ответа.
Если предыдущий скрипт всё ещё выполняется, новый вызов сразу вернёт «Photoshop занят»: закройте диалог, и Photoshop доиграет прерванный скрипт.
Поведение и ограничения
Первый вызов при закрытом Photoshop стоит 10–20 с — COM запускает приложение.
Скриншот окна сначала снимается через
PrintWindow, а если Windows вернул пустой кадр (холст рисуется через GPU) — через Grab экрана; во втором случае окно Photoshop выводится на передний план.Готовые картинки складываются в
out/рядом сserver.py.Диалоги не закрываются автоматически: подтверждать растеризацию или сохранение должен тот, кто вызвал инструмент.
Файлы
server.py MCP-сервер: COM-мост с таймаутом, диалоги, скриншот окна, рендер документа
jsx/psmcp.jsx ExtendScript-обвязка: запуск кода + JSON-сериализатор
tests/smoke.py живой селф-чек инструментов
tests/dialogs.py модальный диалог не вешает сервер
tests/stdio.py MCP-протокол end-to-end
assets/banner.svg шапка READMEЛицензия
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Document processing over MCP: merge, split and compress PDFs, run OCR, extract document text.
Screenshots, PDFs, image editing, QR codes, email validation and more through one hosted MCP server.
Unofficial Browserless MCP — wraps the Browserless headless-Chromium REST API (browserless.io)
Generate and manage Storydoc presentations from any MCP-compatible client.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables remote control of Adobe Photoshop on macOS and Windows via MCP, supporting multiple backends including AppleScript, PowerShell, and UXP plugin.13MIT
- AlicenseNot gradedqualityDmaintenanceEnables automation of Photoshop tasks such as PSD editing, layer toggling, text insertion, and exporting through MCP clients like Claude or Cursor.MIT
- FlicenseNot gradedqualityCmaintenanceEnables AI clients to control Adobe Photoshop on macOS through AppleScript using the Model Context Protocol.-
- AlicenseNot gradedqualityBmaintenanceEnables controlling Adobe Photoshop from an MCP client, providing tools for layers, adjustments, masks, selections, filters, text, actions, and file operations, with configurable permission levels and extension support.1MIT