GPT Image 2 Plugin für Claude Desktop Code

Generieren und bearbeiten Sie Projektbilder mit OpenAI GPT Image 2 über einen gebündelten lokalen MCP-Server. Das Plugin schreibt ein validiertes Bild pro bezahltem Aufruf, behält Dateien innerhalb eines genehmigten Projekt-Workspaces und überschreibt niemals ein vorhandenes Ziel.

简体中文

Unterstützte Claude-Oberfläche

Dieses Plugin ist für Claude Desktop Code, die projektorientierte Code-Erfahrung in der Claude Desktop-Anwendung. Claude Desktop Chat wird nicht unterstützt. Es ist kein MCPB-Paket und kein entfernter MCP-Dienst.

Related MCP server: mcp-openai-images-audio

Installation über die Claude Desktop Code GUI

Die GUI-Plugin-Installation ist der primäre Weg:

1. Öffnen Sie das Zielprojekt in Claude Desktop Code.

2. Öffnen Sie den GUI-Bereich Settings → Plugins. Die Bezeichnungen können je nach Claude-Version leicht variieren.

3. Fügen Sie dieses Repository-Root als lokalen Marktplatz hinzu oder wählen Sie seine Repository-Quelle aus, und installieren Sie dann gpt-image-2@kpk-plugins.

4. Aktivieren Sie das installierte Plugin für das aktuelle Projekt. Die Aktivierung ist projektspezifisch; die Installation gewährt nicht automatisch Zugriff auf jedes Projekt.

5. Öffnen Sie die Plugin-Einstellungen zur Konfiguration. Kopieren Sie .mcp.json nicht in die normalen Einstellungen.

Das Plugin-Root ist der Marktplatz-Root, und der Marktplatz-Eintrag zeigt auf ./.

Laufzeitanforderung

Die einzige Laufzeitabhängigkeit ist Node.js 20+, verfügbar im PATH, der von Claude Desktop Code gesehen wird. Das installierte Plugin startet direkt die vorgebaute dist/server.mjs. Zur Laufzeit führt das Plugin kein npm, npx, Lebenszyklus-Skripte, Quellkompilierung aus und lädt kein node_modules.

Die festgeschriebene Marktplatz-Kopie enthält das eigenständige Bundle. Ein Test der installierten Kopie startet nur Git-verfolgte Dateien und überprüft, ob get_status ohne vorhandenes node_modules-Verzeichnis und ohne API-Schlüssel funktioniert.

npm und Entwicklungsabhängigkeiten werden nur von Mitwirkenden benötigt, die den Quellcode-Checkout erstellen oder testen.

Konfiguration in der GUI

Geben Sie in den Plugin-Einstellungen den API-Schlüssel in das sensible Feld OpenAI API key ein. Setzen Sie ihn nicht in eine Befehlszeile, .env, .mcp.json, normale Einstellungen, eine README, einen Prompt oder ein Log, und bitten Sie Claude nicht, ihn anzuzeigen oder zu überprüfen.

Die standardmäßige offizielle Basis-URL lautet:

https://api.openai.com/v1

Eine benutzerdefinierte Basis-URL empfängt den API-Schlüssel, Prompts und Bearbeitungsbilder, die von diesem Plugin gesendet werden. Konfigurieren Sie eine nur, wenn Sie diesem Endpunkt und seinem Betreiber vertrauen. Ein benutzerdefinierter Endpunkt sollte normalerweise /v1 enthalten; das Plugin hängt es nicht automatisch an. Das einzige benutzerorientierte Dokumentationsbeispiel ist:

https://api.example.invalid/v1

Die URL muss eine absolute HTTP(S)-URL ohne Anmeldeinformationen, Query, Fragment, Steuerzeichen oder umgebende Leerzeichen sein. Ein kompatibler Endpunkt muss die vom OpenAI-Client verwendete Bild-API implementieren; Kompatibilität wird nicht allein durch die Akzeptanz einer URL impliziert.

HTTP ist für vertrauenswürdige lokale oder private Netzwerk-kompatible Endpunkte erlaubt, sendet jedoch den API-Schlüssel, Prompts und Bearbeitungsbilder ohne Transportverschlüsselung. Verwenden Sie eine http://-Basis-URL nur in einem Netzwerk und Endpunkt, dem Sie vertrauen; bevorzugen Sie andernfalls HTTPS.

Führen Sie nach der Installation /gpt-image-2:setup aus. Der Befehl ruft nur get_status auf und stellt keine Provider-Anfrage.

Tools

get_status

Meldet nur sichere Statusdaten: Boolescher Wert, ob API-Schlüssel konfiguriert ist, ob eine benutzerdefinierte Basis-URL konfiguriert ist, base_url_valid: true für die aktive URL eines laufenden Servers, genehmigte Workspace-Roots, Modell, Serverversion und das standardmäßige relative Ausgabeverzeichnis. Eine ungültig konfigurierte Basis-URL verhindert den Serverstart; korrigieren Sie sie in den Plugin-Einstellungen und laden Sie das Plugin neu oder starten Sie es neu. get_status führt null Provider- oder Bild-API-Anfragen durch und gibt niemals den Schlüssel oder den Wert der Basis-URL zurück.

generate_image

Generiert ein Bild mit dem Modell gpt-image-2, festem n: 1, und speichert eine neue Datei. Haupteingaben sind:

• prompt

• quality: auto, low, medium oder high

• size

• output_format: png, jpeg oder webp

• optionale JPEG/WebP output_compression von 0 bis 100

• moderation: auto oder low

• optionaler relativer output_path und genehmigter workspace_root

edit_image

Bearbeitet ein bis acht Bearbeitungseingaben in der angegebenen Reihenfolge und speichert ein neues Bild. Eingaben können PNG, JPEG oder WebP sein. Das Limit beträgt 50 MiB pro Eingabe und 200 MiB insgesamt über alle Bearbeitungsbilder plus die optionale Maske.

Eine optionale Maske muss ein PNG mit einem Alphakanal sein, die Abmessungen des ersten Eingabebildes übereinstimmen und kleiner als 4 MiB sein. Transparente Ausgabehintergründe werden nicht unterstützt; das Masken-Alpha identifiziert nur den Bearbeitungsbereich.

Formate, Größen und Ausgabe

• Ausgabeformate: PNG, JPEG und WebP.

• Die Standardgröße des Tools ist 1024x1024. auto wird ebenfalls akzeptiert.

• Eine benutzerdefinierte WIDTHxHEIGHT muss Vielfache von 16 verwenden, jede Kante darf maximal 3840 Pixel betragen, das Seitenverhältnis muss zwischen 1:3 und 3:1 liegen, und die Gesamtpixelzahl muss zwischen 655.360 und 8.294.400 liegen.

• PNG verwendet keine Ausgabekomprimierung. JPEG und WebP akzeptieren Komprimierungswerte von 0 bis 100.

• Wenn output_path weggelassen wird, erfolgt die Ausgabe unter .claude/generated-images/gpt-image-2 mit einem eindeutigen, promptfreien Dateinamen.

• Explizite Ausgabepfade werden beibehalten, müssen relativ zu einem genehmigten Workspace-Root sein und eine Erweiterung verwenden, die dem angeforderten Format entspricht.

• Vorhandene Ziele werden abgelehnt. Die No-Overwrite-Veröffentlichung verhindert auch, dass gleichzeitige Aufrufe dasselbe Ziel ersetzen.

Die tatsächlichen Abmessungen werden beibehalten und gemeldet, nachdem das gespeicherte Bild dekodiert und validiert wurde. Wenn eine explizit angeforderte Größe abweicht, bleibt die Datei mit ihren tatsächlichen Abmessungen gespeichert, und das Ergebnis enthält SIZE_MISMATCH.

Bilder mit einer Größe von 2 MiB oder weniger enthalten eine Inline-Vorschau. Bei größeren Bildern wird die Inline-Vorschau weggelassen; der gespeicherte Dateipfad bleibt maßgeblich. TEMP_CLEANUP_PENDING bedeutet, dass die Ausgabe erfolgreich gespeichert wurde, aber die Bereinigung einer temporären Veröffentlichungsdatei noch aussteht.

Kosten, Parallelität und Wiederholungen

Generierung und Bearbeitung sind kostenpflichtige Provider-Operationen. Das Plugin fixiert eine Ausgabe pro Anfrage und erlaubt jeweils einen kostenpflichtigen Aufruf pro Serverprozess. Es gibt keine SDK-Wiederholungen und keine Anwendungswiederholungen, sodass ein fehlgeschlagener kostenpflichtiger Aufruf nicht automatisch wiederholt wird. Bestätigen Sie Prompts, Bearbeitungseingaben, Größe, Format und Ausgabepfad, bevor Sie ein Bild-Tool aufrufen.

Workspace- und Sicherheitsgrenze

• Ausgaben bleiben innerhalb eines von Claude Desktop Code genehmigten Workspace-Roots. Ausgabepfade können nicht absolut sein oder den Root verlassen.

• Enthaltene absolute Eingabepfade werden nur akzeptiert, wenn sie bereits innerhalb eines genehmigten Roots aufgelöst werden; ein Eingabepfad gewährt niemals einen neuen Root.

• Eingabedateien werden über stabile Handles in private temporäre Schnappschüsse kopiert, bevor sie hochgeladen werden. Originale werden nicht verändert.

• Provider-Ausgabe wird streng dekodiert, bildvalidiert, geleert und mit No-Overwrite-Semantik veröffentlicht.

• Logs akzeptieren nur begrenzte Statuscodes und numerischen Kontext; Prompts, API-Schlüssel, Basis-URLs, Bilddaten, Base64 und vollständige Eingabepfade sind ausgeschlossen.

Windows Node 20 Junction-Grenze

Unter Windows mit Node 20 werden vorhandene Reparse-Point/Junction-Escapes abgelehnt, und Ausgabe-übergeordnete Pfade werden unmittelbar vor der exklusiven Veröffentlichung erneut überprüft. Ein aktives Verzeichnisersatz durch einen anderen Prozess mit derselben Autorität zwischen den Überprüfungen bleibt außerhalb der Bedrohungsgrenze. Ein nativer Win32-Handle-relativer Helfer wäre erforderlich, um diesen Wettlauf des Ersatzes durch dieselbe Autorität vollständig zu beseitigen.

Fehlerbehebung

• API key not configured: Öffnen Sie die Plugin-Einstellungen von Claude Desktop Code und füllen Sie das sensible API-Schlüsselfeld aus. Fügen Sie den Schlüssel nicht in den Chat oder eine Shell ein.

• Invalid or unused custom Base URL: Eine ungültig konfigurierte Basis-URL verhindert den Serverstart. Korrigieren Sie sie in den Plugin-Einstellungen, bestätigen Sie, dass die Einstellung gespeichert wurde, und laden Sie das Plugin dann neu oder starten Sie es neu. Benutzerdefinierte Endpunkte sollten normalerweise auf /v1 enden; es wird kein /v1-Segment automatisch hinzugefügt.

• No approved workspace root: Öffnen Sie das Projekt in Claude Desktop Code und aktivieren Sie das Plugin für dieses Projekt.

• OUTPUT_EXISTS: Wählen Sie einen neuen relativen Ausgabepfad. Das Plugin wird nicht überschreiben.

• SIZE_MISMATCH: Verwenden Sie die zurückgegebene tatsächliche Breite und Höhe; das gespeicherte Bild ist gültig.

• Preview omitted: Öffnen Sie den zurückgegebenen relativen oder absoluten Pfad; Inline-Vorschauen sind auf 2 MiB begrenzt.

Aus dem Quellcode erstellen und testen

Entwicklungsbefehle können Entwicklungsabhängigkeiten installieren und verwenden; sie sind nicht Teil des Laufzeitverhaltens des installierten Plugins. Der Validierungsbefehl deaktiviert implizite npm-Lifecycle-Hooks, bevor überprüft wird, dass der genehmigte Skriptsatz exakt ist.

npm ci --ignore-scripts
npm run typecheck
npm test
npm run build
npm run test:dist
npm --ignore-scripts run validate

Diese Prüfungen verwenden lokale Fixtures, Fakes und Protokolltests. Es ist keine kostenpflichtige Bildanfrage erforderlich. Es wurde keine Live-Provider-Verifizierung durchgeführt oder beansprucht.

Lizenz

MIT © 2026 KPK. Siehe LICENSE und THIRD_PARTY_NOTICES.md.