alisaitteke/photoshop-mcp

Photoshop MCP – AI 기반 Photoshop 어시스턴트

무엇인가 – Adobe Photoshop에 자연어로 말을 걸 수 있게 해 주는 Node 기반 도구입니다. *“이 인물 사진의 배경을 제거해 줘”*와 같은 요청을 입력하면 LLM(또는 선택적 Jev 라우터)이 요청을 일련의 Photoshop 명령으로 변환하고, 이를 단일 실행 취소 가능한 단계로 실행합니다.

주요 기능

• 배경 제거, 인물 보정, 색상 그레이딩, 하늘 교체, 생성형 채우기(Adobe 계정 필요).
• 일괄 작업 – 폴더에 워터마크 넣기, Instagram 캐러셀 슬라이드 만들기, 웹용 JPEG 내보내기.
• AI가 조합할 수 있는 128개의 내장 “도구”(111개의 원자적 액션 + 17개의 레시피).
• 선택적 Jev 라우팅: 26개의 안전한 명령의 경우 요청이 LLM을 우회하여 Photoshop으로 바로 전송되어 API 토큰을 절약합니다.

사용 방법

1. Photoshop(Windows/macOS, 2012+)을 설치합니다. Node 18+를 설치합니다.
2. 단일 명령으로 내장 UI를 실행합니다:

   npx -p @alisaitteke/photoshop-mcp ui
   

   브라우저 기반 채팅 창이 나타납니다. Claude, Gemini의 API 키로 로그인하거나 내장 Jev 모델(TypeSafe API 키 필요)을 사용합니다.
3. 자연어 프롬프트를 입력합니다. 도구가 단계를 계획하고, 브리지를 통해 Photoshop과 통신하며, 편집을 수행합니다.
4. Cursor, Claude Code, VS Code와 같은 AI 중심 편집기에서 MCP 플러그인을 통해 동일한 브리지를 호출할 수도 있습니다.

아키텍처 개요 – 이 패키지는 Photoshop의 스크립팅 인터페이스를 통해 Photoshop과 통신하는 작은 서버(“MCP 서버”)를 실행하며, LLM(또는 Jev)이 구조화된 계획을 생성합니다. 오류는 파싱되어 자동 재시도를 위해 모델에 피드백됩니다.

상태 – 베타(액션 플랜 기능 플래그). 커뮤니티에서 유지 관리하며 Adobe와 공식적으로 제휴되어 있지 않습니다.

더 알아보기 – 문서에서는 도구 목록, UI 설정, 프롬프트 템플릿, 문제 해결, 기여 방법을 다룹니다.

---

모든 정보는 저장소의 README에서 직접 가져왔습니다.