CLIP STUDIO PAINT 5.1.2 Produktions-MCP

[!IMPORTANT] Inoffizielles Community-Projekt. Dieses Repository ist nicht mit CELSYS verbunden, wird von CELSYS nicht unterstützt oder befürwortet. Es ist eine lokale stdio-MCP-Brücke für Windows + CLIP STUDIO PAINT 5.1.2.0 Produktionsversion + zh-CN + DPI 120. Andere CSP-Versionen, Preview-/Early-Access-Builds, Gebietsschemata, DPI-Werte und Betriebssysteme werden vom gebündelten strikten Profil nicht unterstützt.

Stand 2026-08-25 dokumentiert die für dieses Projekt geprüfte öffentliche CELSYS-Dokumentation keine allgemeine CSP-Dokument-/Ebenen-API, keine Skriptlaufzeit, kein MCP und keine unterstützte Headless-CLI; die veröffentlichte SDK ist auf EX-Filter-Plugins beschränkt. Im validierten 5.1.2-zh-CN-Profil exponieren die benutzerdefiniert gezeichneten Bereiche von CSP auch keine aussagekräftigen Ebenen-, Pinsel- oder Menüobjekte über Windows UI Automation. Dieses Projekt bietet daher 33 bewusst eingeschränkte Fähigkeiten, die auf Sichtfenster-Inspektion, Screenshots, Whitelist-Eingaben, registrierten Tastenkürzeln/Auto-Aktionen und Dateiaustausch basieren. Es ist keine native Ebenen-Objekt-API und kann nicht ehrlich jede interne CSP-Funktion exponieren.

Was enthalten ist

• 33 MCP-Tools; siehe den vollständigen Werkzeugkatalog.

• CSP-Executable-Attestierung: fester Pfad, Authenticode-Signatur, CELSYS-Unternehmensfeld, exakte Dateiversion und SHA-256.

• Per-Monitor-DPI-Awareness V2 mit einem strikten zh-CN-/DPI-120-Produktionsprofil.

• Prozess-, Hauptfenster-, Vordergrundfenster-, Dialog-, Anzeige-, Benutzeraktivitäts-, Screenshot-, Pixelabtast- und Screenshot-Differenz-Inspektion.

• Screenshot-gebundene Zeigerbewegung, Klicks, Doppelklicks, Ziehen, Scrollen, Navigationstasten und Unicode-Text-Eingabe.

• Versionierte Tastenkürzel-Befehle, eingeschränkte Befehlssequenzen und benutzerregistrierte Auto-Aktionen.

• Konfigurierte Pfadwurzeln für Asset-Auflistung, Dateimetadaten, Import-Dispatch, Export-Scanning und stabile Ausgabeverifizierung.

• Strikte native #32770-Dateidialog-Befüllung/-Übermittlung mit expliziter Überschreibungsabsicht.

• Ein Preflight-Bestätigungsprotokoll für alle 10 atomaren Eingabewerkzeuge.

• Nur lokaler stdio-Transport: kein lauschender Port, keine Shell, keine Registrierung, kein beliebiger Prozess und kein uneingeschränktes Dateisystem-Werkzeug.

Datenschutzgrenze

Lokaler stdio bedeutet, dass dieser Server keinen Netzwerk-Listener öffnet; es bedeutet nicht, dass alle MCP-Daten auf der Maschine bleiben. Der MCP-Host empfängt Werkzeugeingaben und -ausgaben, einschließlich Screenshots, sichtbarem UI-Text, Fenstertiteln und konfigurierten absoluten Pfaden, und kann sie gemäß der Datenrichtlinie des Hosts an ein entferntes Modell senden. Halten Sie sensible Dokumente geschlossen, überprüfen Sie die Datenschutzkontrollen des Hosts und behandeln Sie Text oder Bilder, die in CSP angezeigt werden, als unvertrauenswürdige Daten und nicht als Anweisungen für den Agenten.

Related MCP server: atomic-computer-mcp

Unterstützungsmatrix

Das strikte Profil schlägt fehl, wenn die ausführbare Datei, die Tastenkürzel-Dateien, das Gebietsschema, die DPI oder die Fensteridentität nicht übereinstimmen. Entfernen Sie diese Prüfungen nicht, um eine andere Maschine „zum Laufen zu bringen“; erstellen und validieren Sie stattdessen ein neues Profil.

Schnellstart: konfigurieren → installieren → testen → registrieren

Voraussetzungen: Git, CPython 3.13, Codex und der exakt unterstützte CSP-Produktionsbuild. Klonen Sie das Repository in ein vertrauenswürdiges lokales Verzeichnis:

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. Konfigurieren Sie die lokale Maschine

Führen Sie den Konfigurationshelfer vor der Installation aus. Er erstellt eine git-ignorierte lokale Konfiguration; maschinenspezifische CSP-, Tastenkürzel-Profil- und Asset-Root-Pfade dürfen nicht committet werden.

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

Die Konfiguration muss Folgendes identifizieren:

• die Produktions-CLIPStudioPaint.exe;

• die erwartete CELSYS-Signatur, 5.1.2.0-Version und den SHA-256 der ausführbaren Datei;

• die CSP-Tastenkürzel-Einstellungsdateien des aktuellen Benutzers und deren SHA-256-Werte;

• drei separate Asset-Roots: schreibgeschütztes Input, Lese-/Schreib-Working und Lese-/Schreib-Exports.

Sofern nicht explizit überschrieben, findet der Helfer die unterstützten Tastenkürzel-Dateien unter %APPDATA% des aktuellen Benutzers und erstellt den Asset-Root als CSP-MCP-Assets im Dokumentenordner des aktuellen Benutzers. Verwenden Sie -ShortcutProfileFiles und -AssetsRoot, wenn sich diese Speicherorte unterscheiden. Er kopiert auch die inerte mcp-dialog-smoke.svg-Testdatei des Repositorys in den Input-Root, wenn dieser Dateiname fehlt; er überschreibt niemals eine vorhandene Datei.

Zur Laufzeit wird die Konfiguration in dieser Reihenfolge aufgelöst: der absolute Pfad in CSP_MCP_CONFIG, dann config/config.local.json, dann der verfolgte Platzhalter config/config.json. Die verfolgte Datei ist eine Vorlage, kein vertrauenswürdiges Maschinenprofil.

Behandeln Sie generierte Hashes als Attestierung einer Maschine, die Sie bereits inspiziert haben, nicht als Beweis dafür, dass eine beliebige ausführbare Datei oder Tastenkürzel-Datei vertrauenswürdig ist.

2. Installieren Sie gesperrte Abhängigkeiten

& .\scripts\install.ps1

Der Installer erstellt .venv im Repository und installiert mcp==1.29.0, pywin32==312 und Pillow==12.3.0 aus requirements.lock.txt mit erzwungenen Hashes. Wenn die ACL-Prüfung einen nicht vertrauenswürdigen Vorfahren ablehnt, verschieben Sie das Checkout/die Assets in ein vertrauenswürdiges Verzeichnis oder lassen Sie einen Administrator die Vorfahren-ACLs überprüfen. Der explizite Risikoakzeptanz-Schalter überspringt nur das anfängliche Vorfahren-Gate; er repariert keine ACLs und umgeht nicht die endgültige Anforderung, dass jede geprüfte Wurzel und jeder Dateibaum geschützt ist.

3. Testen Sie vor der Registrierung

$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

Kompilierung und Unit-Tests laufen in GitHub Actions unter Windows/Python 3.13. Der stdio-Smoke-Test benötigt zusätzlich eine gültige lokale Konfiguration und die unterstützte CSP-Umgebung. Er ist absichtlich von gehostetem CI ausgeschlossen.

Der optionale interaktive Abnahmetest stellt CSP wieder her und fokussiert es, öffnet einen bekannten Windows-Dateidialog, validiert einen konfigurierten Fixture-Pfad ohne ihn zu übermitteln, bricht genau diesen Dialog ab und vergleicht Screenshots:

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

Führen Sie ihn nur aus, während der unterstützte CSP-Build geöffnet ist, keine Dokument-Speicher-Aufforderung vorhanden ist und Sie nicht gleichzeitig Maus oder Tastatur verwenden. Er ersetzt keine manuelle Überprüfung.

4. Registrieren Sie sich bei Codex

& .\scripts\register-codex.ps1

Starten Sie Codex nach der Registrierung neu, rufen Sie dann csp_health und anschließend csp_capabilities auf. Um die Registrierung zu entfernen, führen Sie aus:

& .\scripts\unregister-codex.ps1

Registrierung und Deregistrierung behalten ein zeitgestempeltes Rollback-Backup neben Codex' config.toml. Dieses Backup enthält die vollständige vorherige Codex-Konfiguration und kann sensible Umgebungswerte enthalten. Die Skripte lehnen Reparse-Punkte oder unsichere Schreib-ACLs an diesem Speicherort ab; schützen Sie das Verzeichnis und löschen Sie veraltete Backups, nachdem Sie bestätigt haben, dass die neue Registrierung funktioniert.

Die Registrierung behält writes als Standard-Genehmigungsmodus. Sie genehmigt automatisch nur die 10 atomaren Verbraucher, die ohne ein vom Server ausgestelltes Einmal-Preflight-Token nicht funktionieren können: Bewegen, Klicken, Ziehen, Scrollen, Text, Navigationstaste, registrierter Befehl, Auto-Aktion, Befehlssequenz und strikter nativer Dateidialog. csp_preflight selbst bleibt genehmigungspflichtig.

Bestätigungs-Token-Ablauf

Für gewöhnliche sichtbare UI-Eingaben:

1. Rufen Sie csp_health, csp_capabilities und csp_get_state auf.

2. Rufen Sie csp_capture für die schreibgeschützte Planung auf.

3. Rufen Sie csp_preflight(operation="input", identifier="exact_tool_name", parameters_json="exact JSON parameters") ohne eine alte Capture-ID auf.

4. Nachdem der Benutzer das Preflight genehmigt hat, rufen Sie sofort erneut csp_capture auf und verifizieren Sie, dass das Ziel noch sichtbar ist.

5. Rufen Sie das exakte atomare Werkzeug mit der frischen captureId, dem zurückgegebenen confirmToken und byte-für-byte äquivalenten Geschäftsparametern auf.

6. Überprüfen Sie die Aufnahme nach der Operation; wiederholen Sie das Preflight für die nächste Eingabe.

Tokens laufen nach 45 Sekunden ab, sind einmalig verwendbar, binden die vollständigen Parameter und die exakte CSP-Fenster-/Dialogidentität und werden durch Vordergrund-, Pixel-, Generierungs- oder Eingabezeitänderungen ungültig. Parameterabweichungen verbrauchen das Token. csp_cancel ist eine enge Ausnahme: Es bleibt host-genehmigungspflichtig und sendet nur ein Escape an das exakte CSP-Hauptfenster oder seinen eindeutigen verifizierten Standarddialog.

Das MCP-Protokoll liefert dem Server keinen kryptografischen Beweis, dass der Mensch eine Host-Aufforderung genehmigt hat. Die Vertrauensgrenze umfasst daher den konfigurierten Codex-Host. Ein bösartiger benutzerdefinierter stdio-Client, der als derselbe Benutzer läuft, ist nicht im Rahmen; siehe das Sicherheitsmodell.

Dateioperationen

Pfadaufnehmende Werkzeuge arbeiten nur innerhalb der drei durch die lokale Konfiguration erstellten Roots. Sie lehnen UNC-/Gerätepfade, alternative Datenströme, Wildcards, reservierte Gerätenamen, Reparse-Punkte, implizites Überschreiben und andere nicht unterstützte Fälle ab. Vorhandene Pfade werden über Handles geprüft und vorhandene Eingaben/Ersetzungsziele werden auf harte Links geprüft, aber diese Minderungen können nicht jede Prüf-zu-Verwendungs-Race eliminieren.

Das Speichern oder Ersetzen einer Datei verwendet diesen expliziten Ablauf:

1. Validieren Sie das exakte Ziel mit csp_validate_path.

2. Preflight und führen Sie den registrierten Befehl document.save_as_dialog aus.

3. Ermitteln Sie die exakten Haupt-/Dialog-HWNDs, dann Preflight csp_native_file_dialog mit dem vollständigen Pfad, der Absicht und dem Submit-Flag.

4. Übermitteln Sie nur über das verifizierte Dateidialog-Steuerelementprofil. Jede spätere Überschreibungs-/Formatierungsaufforderung erfordert manuelle Bearbeitung.

5. Akzeptieren Sie den Abschluss erst, nachdem csp_wait_for_file ein stabiles, nicht leeres Ziel verifiziert und dessen SHA-256 zurückgegeben hat.

Ctrl+S ist nicht registriert, da CSP den aktuellen Dokumentpfad nicht über eine öffentliche API exponiert. Generische Koordinaten-/Textwerkzeuge dürfen nicht für Öffnen/Speichern/Exportieren, Konto, Cloud, Store, Community oder Publishing-Workflows verwendet werden.

csp_open_document sendet CLIPStudioPaint.exe <path> als Argumentarray, da dieses Verhalten in der Referenzbereitstellung beobachtet wurde. CELSYS dokumentiert es nicht als stabilen CLI-Vertrag. Eine erfolgreiche Antwort beweist den Dispatch und CSP-Fensterbeweis, nicht welcher Dokument-Tab den Pfad besitzt; verifizieren Sie das Ergebnis mit einer Aufnahme.

Auto-Aktionen

Die verfolgte Auto-Aktions-Registrierung startet leer. Erstellen und validieren Sie jede Aktion manuell in CSP, binden Sie nur Ctrl+Alt+[Shift]+F1..F12, und registrieren Sie sie dann lokal, wie in Auto-Aktionen-Setup beschrieben.

• Auto-Aktionen sind in CSP PRO/EX verfügbar, nicht in DEBUT.

• Jede Aktion erfordert Preflight und eine exakte registrierte ID.

• Die Produktionskonfiguration lehnt effect: "filesystem" ab.

• Jeder Eintrag muss attested_no_file_io: true attestieren.

• Der Server kann proprietäre .laf-Dateien nicht parsen, daher ist diese Attestierung ein Administratorversprechen und kein technischer Beweis.

Verwenden Sie den dedizierten validierten Datei-Workflow für Öffnen/Speichern/Exportieren.

Projektstruktur

.
├─ 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

Dokumentation und Quellen

• Werkzeugkatalog

• Sicherheitsmodell

• Auto-Aktionen-Setup

• GitHub-Projektvergleich

• OpenAI Codex MCP-Dokumentation

• CELSYS Auto-Aktionen-Handbuch

• CELSYS öffentliche SDK-Seite

• CELSYS unterstützte Öffnen-/Importformate

Entwicklungs- und Release-Grenze

Pull Requests sollten fail-closed Versions-/Signatur-/Profilprüfungen beibehalten und Tests für Verhaltensänderungen hinzufügen. Gehostete CI führt nur Kompilierung und Unit-Tests durch; CSP-abhängige Smoke- und interaktive Validierung erfordern eine explizit vorbereitete Windows-Workstation. Siehe CONTRIBUTING.md und die Sicherheitsrichtlinie.

Das gebündelte Profil wird nur für das oben aufgeführte exakte Ziel validiert. Eine CSP-Aktualisierung, Sprachänderung, DPI-Änderung, Verknüpfungsbearbeitung oder Lizenzeditionsänderung erfordert neue Signatur-/Hash-Prüfungen, Screenshot-Kalibrierung, Verknüpfungsprüfung und nicht-destruktive Abnahmetests, bevor ein neues Profil veröffentlicht wird.

Lizenz und Marken

Das Projekt ist unter der MIT-Lizenz verfügbar. Hinweise zu Drittanbieter-Abhängigkeiten sind in THIRD_PARTY_NOTICES.md dokumentiert.

CLIP STUDIO PAINT und CELSYS sind Marken ihrer jeweiligen Inhaber. Dieses Repository vertreibt keine CELSYS-Software, keinen SDK-Quellcode, keine privaten Protokolle und keinen Reverse-Engineering-Code für das .clip-Format.