Skip to main content
Glama
deenesjakoruzh
francisanderson

photoshop-mcp

by francisanderson
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Local

Photoshop MCP Server

AI 어시스턴트(Claude, opencode, Cursor 등)가 ExtendScript + COM 자동화를 통해 Windows의 Adobe Photoshop을 제어할 수 있게 해주는 Model Context Protocol(MCP) 서버입니다.

**Photoshop 2020(v21.x)**용으로 제작되었지만 최신 버전과도 호환됩니다. 문서, 레이어, 텍스트, 필터, 색상 조정, 선택 및 마스크, 레이어 스타일, 내보내기, 레이아웃 분석, 디자인 QA, Photoshop 상태 검사 등을 다루는 약 122개의 도구를 제공합니다.

비공식 커뮤니티 프로젝트입니다. Adobe와 제휴하거나 보증하지 않습니다.

작동 방식

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

  • UXP가 아닌 ExtendScript — COM을 통한 외부 자동화는 ExtendScript만 사용할 수 있으며, 이는 모든 Photoshop 버전(2012~2025+)에서 작동합니다. UXP는 프로세스 내 플러그인용이며 외부에서 호출할 수 없습니다.

  • 유니코드 안전 — 비ASCII 텍스트(예: £, —)는 생성된 JSX에서 \uXXXX로 이스케이프되고 UTF-8 BOM이 앞에 추가되어 가격/악센트가 올바르게 왕복됩니다.

  • 사용 중 재시도 — 일시적인 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 클라이언트를 다시 시작하여 업데이트된 도구 목록이 로드되도록 합니다.

주요 도구

문서

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

레이어

add_text, add_text_box, add_rectangle, add_image, place_image, duplicate_layer, delete_layer, rename_layer, rasterize_layer, group_layers, merge_visible_layers, flatten_image, 불투명도 / 혼합 모드 / 표시 / 잠금

레이어 작업

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

MCP 클라이언트에서 tools/list를 실행하면 약 122개의 모든 도구를 볼 수 있습니다.

구성 참조

run/

임시 JSX 파일(자동 생성)

snapshots/

시각적 회귀 테스트용 명명된 PNG 스냅샷(render_snapshot)

checkpoints/

롤백용 PSD 백업(save_checkpoint)

design-systems/

저장된 디자인 시스템(save_design_system)

알려진 제한 사항

  • 생성형 AI(Firefly) 및 Neural Filters는 PS 24+ / UXP 브리지 플러그인이 필요하며 ExtendScript로 구동할 수 없습니다.

  • select_subject는 PS 23+가 필요합니다. export_as WebP/AVIF는 PS 23.2+가 필요합니다.

  • PS 2020에서는 모달 대화 상자가 열려 있으면 일부 명령이 "Photoshop이 사용 중"이라는 메시지를 표시합니다. 대화 상자를 닫고 다시 시도하세요.

크레딧

기능 설계는 다음에서 영감을 받았습니다:

둘 다 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