Skip to main content
Glama
deenesjakoruzh
francisanderson

photoshop-mcp

by francisanderson
OverviewSchemaRelated ServersScoreDiscussions
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 installed

A
license - permissive license
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • ImageMcp

    dotlab-hq
    F
    license
    Not graded
    quality
    C
    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 MCP

    jinkeda
    A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that lets AI assistants like Claude control Adobe Illustrator through natural language by executing ExtendScript code and providing document state inspection.
    6
    MIT

View all related MCP servers

Related MCP Connectors

  • Figma MCP Server

    The Figma MCP server brings Figma design context directly into your AI workflow.

  • hithereiamaliff-mcp-nextcloud

    A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

  • slima

    MCP Server for Slima - AI Writing IDE for Novel Authors with AI Beta Reader.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/francisanderson/photoshop-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server