Pixel Workshop MCP
경험·인용·이해관계: 직접 개발하고 Windows에서 설치·실행 및 결과 파일을 검증한 경험입니다.
한국어로 AI에게 요청해 내 컴퓨터의 PNG·JPEG·WebP 이미지를 확인하고 편집하는 무료 MCP입니다. 이미지 파일은 로컬에서 처리합니다.
inspect_image는 형식과 크기를 확인하고, resize_image는 비율을 유지해 축소합니다. convert_image는 세 형식 사이에서 변환하며 투명 이미지의 JPEG 배경은 기본 흰색 또는 지정한 색으로 설정합니다.
Windows 설치 방법
- 검증한 ZIP 바로 다운로드를 눌러 Pixel-Workshop-MCP-source.zip을 저장합니다.
- 다운로드 폴더에서 ZIP을 우클릭하고 ‘모두 압축 풀기’를 선택합니다. 압축을 푼 폴더에서 package.json과 src가 보이는지 확인합니다.
- Node.js 22 이상과 pnpm 11을 준비하고, 해당 폴더에서 PowerShell을 열어 다음 두 명령을 차례로 실행합니다.
pnpm install --frozen-lockfile
pnpm run build
- 입력·출력 폴더를 각각 만든 뒤 README의 클라이언트 설정 예시에서 node, dist/index.js, 두 폴더의 경로를 본인 PC의 절대 경로로 바꿉니다.
사용 예: “사진 원본.png를 800×800 안에 맞춰줘.” Windows에서 1600×900 원본이 800×450으로 저장되는 것을 확인했습니다. 정지 이미지 입력은 20 MiB·4천만 픽셀 이하, 출력은 각 변 8192px 이하입니다.
공개 ZIP 검증 (2026-11-22, Windows)
GitHub에서 내려받은 ZIP을 새 폴더에 풀어 설치하고 빌드했습니다. 실제 MCP 클라이언트에서 inspect_image가 1600×900 PNG를 식별했고, resize_image의 결과 파일을 다시 열어 800×450을 확인했습니다. convert_image로 PNG·JPEG·WebP 사이를 변환하고, 투명 PNG를 JPEG로 바꾼 결과의 기본 흰색과 지정 녹색 배경을 픽셀로 확인했습니다. 전체 테스트는 14개 통과, 실패 0개였고 파일 심볼릭 링크 검사 1개는 Windows 권한 때문에 건너뛰었습니다.
Codex 연결 (Windows PowerShell)
빌드한 폴더에서 다음 명령을 실행하세요. Codex CLI와 Node.js가 설치되어 있어야 합니다.
$i = Join-Path $env:USERPROFILE "Pixel Workshop\입력"
$o = Join-Path $env:USERPROFILE "Pixel Workshop\출력"
New-Item -ItemType Directory -Force $i, $o | Out-Null
$server = (Resolve-Path ".\dist\index.js").Path
codex mcp add pixel-workshop -- (Get-Command node).Source $server --input-dir $i --output-dir $o
codex mcp get pixel-workshop
enabled: true, transport: stdio가 보이면 입력 폴더에 이미지를 넣고 새 Codex 세션에서 요청하세요.
2026-11-22 Windows에서 게시글의 ZIP으로 설치한 뒤 새 Codex CLI 세션에 “설치 확인 1600.png의 크기를 알려줘. 800×800 안에 맞춰 축소하고, 원본은 녹색(#00ff00) 배경 JPEG로 변환해줘”라고 요청했습니다. inspect_image는 1600×900 PNG를 식별했습니다. resize_image가 저장한 PNG를 다시 열어 800×450과 투명 픽셀을 확인했고, convert_image가 저장한 JPEG에서 1600×900과 배경 픽셀 RGB (0, 255, 1)을 확인했습니다. 결과 파일은 출력 폴더에 저장됩니다.
출처: https://github.com/rasidjin/pixel-workshop-mcp · 확인 2026-11-22