Skip to main content
Glama
deenesjakoruzh
francisanderson

photoshop-mcp

by francisanderson
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

Photoshop MCP Server

Сервер Model Context Protocol (MCP), который позволяет ИИ-ассистентам (Claude, opencode, Cursor и др.) управлять Adobe Photoshop на Windows через ExtendScript и COM-автоматизацию.

Создан для Photoshop 2020 (v21.x), но совместим с более новыми версиями. ~122 инструмента, охватывающих документы, слои, текст, фильтры, корректировку цвета, выделения и маски, стили слоёв, экспорт, анализ макета, QA дизайна и проверку состояния Photoshop.

Неофициальный общественный проект. Не связан с Adobe и не одобрен Adobe.

Как это работает

MCP client (opencode/Claude) 
   → Node MCP server (server.js, stdio)
   → bridge.ps1 (PowerShell)
   → Photoshop COM (Application.DoJavaScriptFile)
   → ExtendScript DOM

  • ExtendScript, а не UXP — внешняя автоматизация через COM может использовать только ExtendScript, который работает во всех версиях Photoshop (2012–2025+). UXP предназначен для плагинов внутри процесса и не может вызываться извне.

  • Unicode-safe — не-ASCII текст (например, £, —) экранируется в \uXXXX в генерируемом JSX и добавляется BOM UTF-8, поэтому цены и диакритические знаки корректно переносятся.

  • Повтор при занятости — временные ошибки COM RPC_E_SERVERCALL_RETRYLATER («приложение занято») повторяются с обратной задержкой.

Related MCP server: ImageMcp

Требования

  • Windows

  • Установленный Adobe Photoshop (протестировано на PS 2020 / v21.2)

  • Node.js 18+

Установка

npm install

Настройка в качестве MCP-сервера

Добавьте в конфигурацию вашего MCP-клиента (например, ~/.config/opencode/opencode.jsonc, Claude Desktop, Cursor):

{
  "mcpServers": {
    "photoshop": {
      "command": "node",
      "args": ["C:\\path\\to\\photoshop-mcp\\server.js"]
    }
  }
}

Перезапустите MCP-клиент после изменений, чтобы обновился список инструментов.

Основные возможности

Область

Инструменты

Документы

create_document, open_image, save_psd, export_image, export_as, crop_document, resize_image, close_document, generate_variants

Слои

create_layer, add_text, add_text_box, create_rectangle, add_image, place_image, duplicate_layer, delete_layer, rename_layer, rasterize_layer, group_layers, merge_visible_layers, flatten_image, opacity / blend mode / visibility / lock

Операции со слоями

move_layer, resize_layer, rotate_layer, move_layer_up/down/to_position, fit_layer_to_document, align_layers, distribute_layers, center_in_canvas, snap_to_safe_area

Текст

list_fonts, check_font_available, set_font, set_color, set_text_alignment, update_text_content, fit_text, fit_text_to_box

Фильтры

apply_gaussian_blur, apply_sharpen, apply_noise, apply_motion_blur

Цвет

adjust_brightness_contrast, adjust_hue_saturation, auto_levels, auto_contrast, desaturate_layer, invert_layer, adjust_curves, apply_lut, adjust_vibrance, adjust_exposure, apply_photo_filter, apply_gradient_map

Выделение и маски

select_rectangle, select_all, deselect, invert_selection, create_layer_mask, delete_layer_mask, apply_layer_mask, apply_gradient_mask, content_aware_fill

Стили слоёв

apply_layer_style (тень / внешнее свечение / обводка)

История

undo, redo, get_history, save_checkpoint, restore_checkpoint

Раскладка / QA

analyze_layout, detect_overlaps, validate_layout, design_qa, visual_hierarchy, brand_check, execute_design_plan, apply_constraints

Дизайн-система

save_design_system, load_design_system, list_design_systems, capture_design_system, create_component

Интроспекция

get_version, get_capabilities, get_state, get_session_info, get_active_document_info, get_selection_info, get_document_info, list_layers, get_layer_bounds, get_preview, render_preview

Данные

image_stack, list_datasets, import_datasets, generate_from_datasets

Автоматизация

play_action, execute_script

Выполните tools/list в вашем MCP-клиенте, чтобы увидеть все ~122 инструмента.

Справка по конфигурации

run/

Временные JSX-файлы (создаются автоматически)

snapshots/

Именованные PNG-снимки для визуальной проверки (render_snapshot)

checkpoints/

Резервные копии PSD для отката (save_checkpoint)

design-systems/

Сохранённые дизайн-системы (save_design_system)

Известные ограничения

  • Генеративный ИИ (Firefly) и Neural Filters требуют PS 24+ / моста UXP и не могут вызываться через ExtendScript.

  • Команда select_subject требует PS 23+. Форматы WebP/AVIF в export_as требуют PS 23.2+.

  • На PS 2020 некоторые команды вызывают сообщение «фотошоп занян», если открыто диалоговое окно — закройте его и повторите.

Благодарности

Дизайн возможностей основан на:

Оба проекта лицензированы MIT. Этот проект — независимая реализация с дополнительными инструментами (анализ макета, QA дизайна, дизайн-системы, визуальная регрессия).

Лицензия

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • ImageMcp

    dotlab-hq
    F
    license
    Not graded
    quality
    D
    maintenance
    A full-featured image processing MCP server for AI assistants, exposing ~55 tools across 11 categories for editing, layers, conversion, AI segmentation/cleanup/generation, design analysis, and screenshot-to-code.
    -

  • Illustrator AI MCP Server

    Gokul2
    F
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that lets AI assistants control Adobe Illustrator locally—running ExtendScript, capturing canvas screenshots, exporting artwork, and optionally remembering techniques—all without network activity.
    -