alisaitteke/photoshop-mcp

What it solves

Photoshop MCP는 AI 어시스턴트를 통해 Adobe Photoshop을 제어하는 데 따르는 어려움을 해결합니다. 표준 자동화 스크립트는 종종 취약하고 문맥이 부족하여, AI 에이전트가 시행착오를 거치느라 토큰을 낭비하거나 문서를 일관성 없는 상태로 남겨두는 원인이 됩니다. 이 프로젝트는 AI 어시스턴트에게 상태 인지 능력을 부여하고 자연어를 사용하여 복잡한 디자인 워크플로우를 실행할 수 있는 구조화된 방법을 제공하는 강력한 브리지 역할을 합니다.

How it works

이 프로젝트는 LLM(Claude 또는 Cursor와 같은)이 프로그래밍 방식으로 Photoshop을 제어할 수 있도록 하는 Model Context Protocol (MCP) 서버를 구현합니다. 시스템의 특징은 다음과 같습니다:

• State Awareness: get_state 및 get_preview와 같은 도구는 AI가 현재 문서를 확인하고 base64 JPEG를 통해 결과를 검증할 수 있게 합니다.
• Recipe Tools: 배경 제거, 색상 보정 등과 같이 여러 단계의 프로세스를 하나의 실행 취소 가능한 단일 작업으로 묶는 16개의 고수준 "recipes"를 제공합니다.
• Prompt Layer: LLM이 모호한 사용자 요청을 정확한 도구 호출로 변환할 수 있도록 돕는 23개의 사전 설계된 템플릿을 제공합니다.
• Standalone UI: IDE 없이도 Photoshop을 구동할 수 있도록 API 키 또는 기존 CLI 구독(Claude Code/Gemini CLI)을 지원하는 로컬 웹 인터페이스를 제공합니다.
• Action Plan (beta): 한 번의 LLM 호출로 전체 단계 시퀀스를 계획하고 이를 한 번에 실행하여 왕복 횟수를 줄이는 모드입니다.

Who it’s for

반복적인 Photoshop 작업을 자동화하거나, 데이터 기반 그래픽을 생성하거나, 자연어 명령을 사용하여 복잡한 이미지 조작을 수행하고자 하는 디자이너와 개발자들을 위한 프로젝트입니다.

Highlights

• 118 Total Tools: 102개의 원자적 도구와 16개의 결과 중심형 recipes가 포함되어 있습니다.
• Generative AI Integration: generative fill, expand, upscale과 같은 Adobe Firefly 기능을 지원합니다.
• Neural Filter Support: 선택 사항인 UXP bridge plugin을 통해 skin smoothing, depth blur, colorization에 접근할 수 있습니다.
• Non-Destructive Workflows: 원본 픽셀을 보존하기 위해 recipes는 단일 실행 취소(undo) 단계로 설계되었습니다.
• Flexible Auth: API 키 또는 CLI OAuth 세션을 통해 다양한 제공업체(Anthropic, OpenAI, Google, OpenRouter)를 지원합니다.