loonghao/photoshop-python-api-mcp-server

: 이 서버는 Windows 전용 COM 인터페이스에 대한 의존성으로 인해 Windows 운영 체제에서만 작동합니다. ⚠️ WINDOWS 전용

photoshop-python-api를 사용하여 Photoshop 통합을 위한 Model Context Protocol (MCP) 서버입니다.

English | 简体中文

이 프로젝트는 Model Context Protocol (MCP)과 Adobe Photoshop 사이의 가교를 제공하여, AI 어시스턴트 및 기타 MCP 클라이언트가 Photoshop을 프로그래밍 방식으로 제어할 수 있도록 합니다.

이 MCP 서버를 통해 AI 어시스턴트는 다음과 같은 작업을 수행할 수 있습니다:

• Photoshop 문서 생성, 열기 및 저장
• 레이어(텍스트, 단색 등) 생성 및 조작
• Photoshop 세션 및 문서에 대한 정보 가져오기
• 이미지에 효과 및 조정 적용
• 그 외 훨씬 더 많은 기능!

🔴 WINDOWS OS 전용: 이 서버는 오직 Windows 운영 체제에서만 작동합니다 - 이 서버는 Photoshop과 통신하기 위해 Windows 전용 COM 인터페이스에 의존합니다.

• macOS 및 Linux는 지원되지 않으며 이 소프트웨어를 실행할 수 없습니다.

Adobe Photoshop: 로컬에 설치되어 있어야 합니다 (CC2017부터 2024 버전까지 테스트됨)
Python: 버전 3.10 이상

참고: 이 패키지는 Windows 시스템에서만 작동한다는 점을 기억하세요.

# pip를 사용하여 설치
pip install photoshop-mcp-server
# 또는 uv를 사용하여 설치
...

이 서버는 다양한 MCP 호스트와 함께 작동하도록 설계되었습니다. PS_VERSION 환경 변수는 연결할 Photoshop 버전을 지정하는 데 사용됩니다 (예: "2024", "2023", "2022" 등).

서버를 구성하는 권장 방법은 공식 표준 형식인 uvx를 명령어로 사용하는 것입니다.

다음 내용을 MCP 호스트 설정에 추가하세요 (Claude Desktop, Windsurf, Cline 및 기타 MCP 호스트에서 작동함):

{
"mcpServers": {
"photoshop": {
...

PS_VERSION: 연결할 Photoshop 버전을 지정합니다 (예: "2024", "2023", "2022" 등)
command: 표준 접근 방식을 위해 uvx를 사용하세요
args: Photoshop MCP 서버를 실행하기 위해 ["photoshop-mcp-server"]를 사용하세요

• Python 버전을 명시적으로 지정하려면 ["--python", "3.10", "photoshop-mcp-server"]를 사용하세요 (3.10부터 3.14 사이의 모든 버전이 지원됩니다)

• Python 버전을 명시적으로 지정하려면 다음을 사용하세요:

photoshop://info

• Photoshop 애플리케이션 정보 가져오기
  photoshop://document/info

• 활성 문서(active document) 정보 가져오기
  photoshop://document/layers

• 활성 문서의 레이어(layers) 가져오기

이 서버는 Photoshop을 제어하기 위한 다양한 도구(tools)를 제공합니다:

문서 도구 (Document Tools): 문서 생성, 열기 및 저장
레이어 도구 (Layer Tools): 텍스트 레이어, 단색(solid color) 레이어 등 생성
세션 도구 (Session Tools): Photoshop 세션, 활성 문서, 선택 영역에 대한 정보 가져오기

MCP 호스트(host)에 구성되면, AI 어시스턴트 대화에서 Photoshop MCP 서버를 사용할 수 있습니다. 시작을 위한 몇 가지 프롬프트(prompts) 예시는 다음과 같습니다:

사용자: 새로운 Photoshop 문서를 생성하고 "Hello World"라는 텍스트 레이어를 추가해 줄래?
AI 어시스턴트: 새로운 문서를 생성하고 텍스트 레이어를 추가해 드릴게요.
[AI가 Photoshop MCP 서버를 사용하여 수행하는 작업:
...

사용자: 내 최신 PSD 파일을 열고 레이어가 몇 개인지 알려줘.
AI 어시스턴트: 최신 PSD 파일을 확인하고 레이어 개수를 세어 볼게요.
[AI가 Photoshop MCP 서버를 사용하여 수행하는 작업:
...

사용자: 그라데이션 배경과 굵은 글꼴의 "Summer Sale" 텍스트가 포함된 소셜 미디어 게시물을 만들어줘.
AI 어시스턴트: 요청하신 소셜 미디어 게시물을 만들어 드릴게요.
[AI가 Photoshop MCP 서버를 사용하여 수행하는 작업:
...

MIT

• photoshop-python-api - Photoshop을 위한 Python API
• Model Context Protocol - MCP Python SDK