CLIP STUDIO PAINT 5.1.2 프로덕션 MCP

[!IMPORTANT] 비공식 커뮤니티 프로젝트입니다. 이 저장소는 CELSYS와 제휴, 보증, 지원되지 않습니다. 이는 Windows + CLIP STUDIO PAINT 5.1.2.0 프로덕션 + zh-CN + DPI 120용 로컬 stdio MCP 브리지입니다. 다른 CSP 버전, 프리뷰/얼리 액세스 빌드, 로케일, DPI 값, 운영 체제는 번들된 엄격한 프로필에서 지원되지 않습니다.

2026-08-25 기준으로 이 프로젝트를 위해 검토된 CELSYS 공개 문서에는 일반적인 용도의 CSP 문서/레이어 API, 스크립팅 런타임, MCP 또는 지원되는 헤드리스 CLI가 문서화되어 있지 않습니다. 게시된 SDK는 EX 필터 플러그인으로 제한됩니다. 검증된 5.1.2 zh-CN 프로필에서 CSP의 사용자 지정 그리기 영역은 Windows UI 자동화를 통해 의미 있는 레이어, 브러시 또는 메뉴 개체를 노출하지 않습니다. 따라서 이 프로젝트는 표시된 창 검사, 스크린샷, 허용 목록 입력, 등록된 단축키/자동 동작, 파일 교환을 기반으로 구축된 33개의 의도적으로 제한된 기능을 제공합니다. 이는 네이티브 레이어 개체 API가 아니며 모든 내부 CSP 기능을 정직하게 노출할 수 없습니다.

포함 내용

• 33개의 MCP 도구; 전체 도구 카탈로그를 참조하세요.

• CSP 실행 파일 증명: 고정 경로, Authenticode 서명, CELSYS 회사 필드, 정확한 파일 버전, SHA-256.

• 모니터별 DPI 인식 V2 및 엄격한 zh-CN / DPI 120 프로덕션 프로필.

• 프로세스, 기본 창, 전경 창, 대화 상자, 디스플레이, 사용자 활동, 스크린샷, 픽셀 샘플링, 스크린샷 차이 검사.

• 스크린샷에 바인딩된 포인터 이동, 클릭, 더블 클릭, 드래그, 스크롤, 탐색 키, 유니코드 텍스트 입력.

• 버전이 지정된 단축키 명령, 제한된 명령 시퀀스, 사용자 등록 자동 동작.

• 자산 목록, 파일 메타데이터, 가져오기 디스패치, 내보내기 스캔, 안정적인 출력 검증을 위한 구성된 경로 루트.

• 명시적 덮어쓰기 의도가 있는 엄격한 네이티브 #32770 파일 대화 상자 채우기/제출.

• 10개의 원자적 입력 도구 모두에 대한 사전 점검 확인 프로토콜.

• 로컬 stdio 전송만: 수신 포트, 셸, 레지스트리, 임의 프로세스 또는 무제한 파일 시스템 도구가 없습니다.

개인 정보 보호 경계

로컬 stdio는 이 서버가 네트워크 수신기를 열지 않음을 의미합니다. 모든 MCP 데이터가 머신에 남아 있다는 의미는 아닙니다. MCP 호스트는 도구 입력과 출력(스크린샷, 표시된 UI 텍스트, 창 제목, 구성된 절대 경로 포함)을 수신하며 해당 호스트의 데이터 정책에 따라 원격 모델로 보낼 수 있습니다. 민감한 문서를 닫아 두고, 호스트의 개인 정보 보호 제어를 검토하고, CSP 내부에 표시된 텍스트나 이미지를 에이전트에 대한 지침이 아닌 신뢰할 수 없는 데이터로 취급하세요.

Related MCP server: atomic-computer-mcp

지원 매트릭스

엄격한 프로필은 실행 파일, 단축키 파일, 로케일, DPI 또는 창 ID가 일치하지 않으면 실패로 닫힙니다. 다른 머신을 "작동"시키기 위해 해당 검사를 제거하지 마세요. 대신 새 프로필을 만들고 검증하세요.

빠른 시작: 구성 → 설치 → 테스트 → 등록

전제 조건: Git, CPython 3.13, Codex, 정확히 지원되는 CSP 프로덕션 빌드. 신뢰할 수 있는 로컬 디렉터리에 저장소를 복제하세요:

git clone https://github.com/A2pha/clip-studio-paint-5.1.2-production-mcp.git
Set-Location .\clip-studio-paint-5.1.2-production-mcp

1. 로컬 머신 구성

설치 전에 구성 도우미를 실행하세요. gitignore된 로컬 구성을 생성합니다. 머신별 CSP, 단축키 프로필, 자산 루트 경로는 커밋하면 안 됩니다.

$CspExecutable = Read-Host 'Absolute path to CLIPStudioPaint.exe 5.1.2 production'
& .\scripts\configure.ps1 -CspExecutable $CspExecutable

구성은 다음을 식별해야 합니다:

• 프로덕션 CLIPStudioPaint.exe;

• 예상 CELSYS 서명, 5.1.2.0 버전, 실행 파일 SHA-256;

• 현재 사용자의 CSP 단축키 설정 파일 및 해당 SHA-256 값;

• 세 개의 별도 자산 루트: 읽기 전용 Input, 읽기/쓰기 Working, 읽기/쓰기 Exports.

명시적으로 재정의하지 않는 한 도우미는 현재 사용자의 %APPDATA% 아래에서 지원되는 단축키 파일을 발견하고 현재 사용자의 문서 폴더 아래에 CSP-MCP-Assets로 자산 루트를 만듭니다. 해당 위치가 다른 경우 -ShortcutProfileFiles 및 -AssetsRoot를 사용하세요. 또한 해당 파일 이름이 없을 때 저장소의 비활성 mcp-dialog-smoke.svg 픽스처를 Input 루트에 복사합니다. 기존 파일을 덮어쓰지 않습니다.

런타임에 구성은 다음 순서로 해석됩니다: CSP_MCP_CONFIG의 절대 경로, 그 다음 config/config.local.json, 그 다음 추적된 자리 표시자 config/config.json. 추적된 파일은 템플릿이지 신뢰할 준비가 된 머신 프로필이 아닙니다.

생성된 해시는 이미 검사한 머신의 증명으로 취급하세요. 임의의 실행 파일이나 단축키 파일이 신뢰할 수 있다는 증거가 아닙니다.

2. 잠긴 종속성 설치

& .\scripts\install.ps1

설치 프로그램은 저장소에 .venv를 만들고 requirements.lock.txt에서 mcp==1.29.0, pywin32==312, Pillow==12.3.0을 해시를 적용하여 설치합니다. ACL 감사가 신뢰할 수 없는 상위 항목을 거부하면 체크아웃/자산을 신뢰할 수 있는 디렉터리로 이동하거나 관리자가 상위 ACL을 검토하도록 하세요. 명시적 위험 수용 스위치는 초기 상위 게이트만 건너뜁니다. ACL을 복구하거나 감사된 모든 루트와 파일 트리가 보호되어야 한다는 최종 요구 사항을 우회하지 않습니다.

3. 등록 전 테스트

$Python = Join-Path $PWD '.venv\Scripts\python.exe'

& $Python -X utf8 -m compileall -q csp_mcp server.py tests
& $Python -X utf8 -m unittest discover -s tests -p 'test_*.py' -v
& $Python -X utf8 .\tests\smoke_stdio.py

컴파일 및 단위 테스트는 Windows/Python 3.13의 GitHub Actions에서 실행됩니다. stdio 스모크 테스트는 추가로 유효한 로컬 구성과 지원되는 CSP 환경이 필요합니다. 호스팅된 CI에서 의도적으로 제외됩니다.

선택적 대화형 수용 테스트는 CSP를 복원하고 포커스하고, 알려진 Windows 파일 대화 상자를 열고, 제출하지 않고 구성된 픽스처 경로를 검증하고, 해당 정확한 대화 상자를 취소하고, 스크린샷을 비교합니다:

& $Python -X utf8 .\tests\acceptance_interactive.py

지원되는 CSP 빌드가 열려 있고, 문서 저장 프롬프트가 없고, 마우스나 키보드를 동시에 사용하지 않는 동안에만 실행하세요. 수동 검토를 대체하지 않습니다.

4. Codex에 등록

& .\scripts\register-codex.ps1

등록 후 Codex를 다시 시작한 다음 csp_health를 호출하고 csp_capabilities를 호출하세요. 등록을 제거하려면 다음을 실행하세요:

& .\scripts\unregister-codex.ps1

등록 및 등록 해제는 Codex의 config.toml 옆에 타임스탬프가 있는 롤백 백업을 유지합니다. 해당 백업에는 이전 Codex 구성 전체가 포함되며 민감한 환경 값이 포함될 수 있습니다. 스크립트는 해당 위치에서 재분석 지점 또는 안전하지 않은 쓰기 ACL을 거부합니다. 디렉터리를 보호하고 새 등록이 작동하는지 확인한 후 오래된 백업을 삭제하세요.

등록은 writes를 기본 승인 모드로 유지합니다. 서버에서 발급한 일회용 사전 점검 토큰 없이는 작동할 수 없는 10개의 원자적 소비자(이동, 클릭, 드래그, 스크롤, 텍스트, 탐색 키, 등록된 명령, 자동 동작, 명령 시퀀스, 엄격한 네이티브 파일 대화 상자)만 자동 승인합니다. csp_preflight 자체는 승인 게이트로 유지됩니다.

확인 토큰 흐름

일반적인 표시 UI 입력의 경우:

1. csp_health, csp_capabilities, csp_get_state를 호출하세요.

2. 읽기 전용 계획을 위해 csp_capture를 호출하세요.

3. 이전 캡처 ID 없이 csp_preflight(operation="input", identifier="exact_tool_name", parameters_json="exact JSON parameters")를 호출하세요.

4. 사용자가 사전 점검을 승인한 후 즉시 csp_capture를 다시 호출하고 대상이 여전히 표시되는지 확인하세요.

5. 새 captureId, 반환된 confirmToken, 바이트 단위로 동일한 비즈니스 매개 변수로 정확한 원자적 도구를 호출하세요.

6. 작업 후 캡처를 검사하고 다음 입력에 대해 사전 점검을 반복하세요.

토큰은 45초 후에 만료되고, 일회용이며, 전체 매개 변수와 정확한 CSP 창/대화 상자 ID를 바인딩하고, 전경, 픽셀, 생성 또는 입력 시간 변경으로 무효화됩니다. 매개 변수 불일치는 토큰을 소비합니다. csp_cancel은 좁은 예외입니다. 호스트 승인 게이트로 유지되며 정확한 CSP 기본 창 또는 고유한 검증된 표준 대화 상자에만 Escape 하나를 보냅니다.

MCP 프로토콜은 서버에 사람이 호스트 프롬프트를 승인했다는 암호화 증거를 제공하지 않습니다. 따라서 신뢰 경계에는 구성된 Codex 호스트가 포함됩니다. 동일한 사용자로 실행되는 악의적인 사용자 지정 stdio 클라이언트는 범위를 벗어납니다. 보안 모델을 참조하세요.

파일 작업

경로를 사용하는 도구는 로컬 구성에서 만든 세 개의 루트 내에서만 작동합니다. UNC/장치 경로, 대체 데이터 스트림, 와일드카드, 예약된 장치 이름, 재분석 지점, 암시적 덮어쓰기 및 기타 지원되지 않는 경우를 거부합니다. 기존 경로는 핸들을 통해 확인되고 기존 입력/교체 대상은 하드 링크가 확인되지만 이러한 완화는 모든 확인-사용 경쟁을 제거할 수 없습니다.

파일 저장 또는 교체는 다음 명시적 흐름을 사용합니다:

1. csp_validate_path로 정확한 대상을 검증하세요.

2. 등록된 document.save_as_dialog 명령을 사전 점검하고 실행하세요.

3. 정확한 기본/대화 상자 HWND를 얻은 다음 전체 경로, 의도, 제출 플래그로 csp_native_file_dialog를 사전 점검하세요.

4. 검증된 파일 대화 상자 제어 프로필을 통해서만 제출하세요. 이후의 덮어쓰기/형식 프롬프트는 수동 처리가 필요합니다.

5. csp_wait_for_file이 안정적이고 비어 있지 않은 대상을 확인하고 SHA-256을 반환한 후에만 완료를 수락하세요.

Ctrl+S는 CSP가 공개 API를 통해 현재 문서 경로를 노출하지 않기 때문에 등록되지 않습니다. 일반 좌표/텍스트 도구는 열기/저장/내보내기, 계정, 클라우드, 스토어, 커뮤니티 또는 게시 워크플로에 사용해서는 안 됩니다.

csp_open_document는 참조 배포에서 해당 동작이 관찰되었기 때문에 CLIPStudioPaint.exe <path>를 인수 배열로 디스패치합니다. CELSYS는 이를 안정적인 CLI 계약으로 문서화하지 않습니다. 성공적인 응답은 디스패치 및 CSP 창 증거를 증명하며, 어떤 문서 탭이 경로를 소유하는지 증명하지 않습니다. 캡처로 결과를 확인하세요.

자동 동작

추적된 자동 동작 레지스트리는 비어 있는 상태로 시작합니다. CSP에서 각 동작을 만들고 수동으로 검증하고, Ctrl+Alt+[Shift]+F1..F12만 바인딩한 다음 자동 동작 설정에 설명된 대로 로컬로 등록하세요.

• 자동 동작은 CSP PRO/EX에서 사용할 수 있으며 DEBUT에서는 사용할 수 없습니다.

• 모든 동작에는 사전 점검과 정확한 등록 ID가 필요합니다.

• 프로덕션 구성은 effect: "filesystem"을 거부합니다.

• 각 항목은 attested_no_file_io: true를 증명해야 합니다.

• 서버는 독점 .laf 파일을 구문 분석할 수 없으므로 해당 증명은 기술적 증거가 아닌 관리자 약속입니다.

열기/저장/내보내기에는 전용 검증 파일 워크플로를 사용하세요.

프로젝트 레이아웃

.
├─ csp_mcp\                 MCP application, policy, controller, Win32 backend
├─ config\                  tracked examples and registries
├─ docs\                    tools, security, research, Auto Actions
├─ scripts\                 configure, install, register, unregister, ACL audit
├─ tests\                   unit, stdio smoke, opt-in interactive acceptance
├─ server.py                stdio entry point
├─ pyproject.toml
├─ requirements.txt
└─ requirements.lock.txt

문서 및 출처

• 도구 카탈로그

• 보안 모델

• 자동 동작 설정

• GitHub 프로젝트 비교

• OpenAI Codex MCP 문서

• CELSYS 자동 동작 매뉴얼

• CELSYS 공개 SDK 페이지

• CELSYS 지원 열기/가져오기 형식

개발 및 릴리스 경계

풀 리퀘스트는 실패 시 폐쇄(fail-closed) 방식의 버전/서명/프로필 검사를 유지하고 동작 변경에 대한 테스트를 추가해야 합니다. 호스팅 CI는 컴파일과 단위 테스트만 수행하며, CSP에 의존하는 스모크 및 대화형 검증은 명시적으로 준비된 Windows 워크스테이션이 필요합니다. CONTRIBUTING.md 및 보안 정책을 참조하세요.

번들 프로필은 위에 나열된 정확한 대상에 대해서만 검증됩니다. CSP 업데이트, 언어 변경, DPI 변경, 단축키 편집 또는 라이선스 에디션 변경은 새 프로필이 게시되기 전에 새로운 서명/해시 검사, 스크린샷 보정, 단축키 검증 및 비파괴적 승인 테스트가 필요합니다.

라이선스 및 상표

이 프로젝트는 MIT 라이선스에 따라 제공됩니다. 타사 종속성 고지 사항은 THIRD_PARTY_NOTICES.md에 기록되어 있습니다.

CLIP STUDIO PAINT 및 CELSYS는 각 소유자의 상표입니다. 이 저장소는 CELSYS 소프트웨어, SDK 소스, 비공개 프로토콜 또는 리버스 엔지니어링된 .clip 형식 코드를 배포하지 않습니다.