openai-gpt-image-mcp

Name: OpenAI GPT Image MCP
Author: SureScaleAI

Ein Model Context Protocol (MCP)-Toolserver für die GPT-4o/gpt-image-1-APIs zur Bildgenerierung und -bearbeitung von OpenAI.

Generieren Sie Bilder aus Textaufforderungen mithilfe der neuesten Modelle von OpenAI.
Bearbeiten Sie Bilder (Inpainting, Outpainting, Compositing) mit erweiterter Eingabeaufforderungssteuerung.
Unterstützt : Claude Desktop, Cursor, VSCode, Windsurf und jeden MCP-kompatiblen Client.

✨ Funktionen

create-image : Generieren Sie Bilder aus einer Eingabeaufforderung mit erweiterten Optionen (Größe, Qualität, Hintergrund usw.).
Bild bearbeiten : Bearbeiten oder erweitern Sie Bilder mithilfe einer Eingabeaufforderung und einer optionalen Maske. Dabei werden sowohl Dateipfade als auch Base64-Eingaben unterstützt.
Dateiausgabe : Speichern Sie generierte Bilder direkt auf der Festplatte oder empfangen Sie sie als Base64.

Related MCP server: Deep Thinking Assistant

🚀 Installation

git clone https://github.com/SureScaleAI/openai-gpt-image-mcp.git cd openai-gpt-image-mcp yarn install yarn build

🔑 Konfiguration

Zur Claude Desktop- oder VSCode-Konfiguration (einschließlich Cursor/Windsurf) hinzufügen:

{ "mcpServers": { "openai-gpt-image-mcp": { "command": "node", "args": ["/absolute/path/to/dist/index.js"], "env": { "OPENAI_API_KEY": "sk-..." } } } }

⚡ Fortgeschritten

Legen Sie für create-image den Wert n fest, um bis zu 10 Bilder gleichzeitig zu generieren.
Geben Sie für edit-image ein Maskenbild (Dateipfad oder Base64) an, um zu steuern, wo Änderungen angewendet werden.
Alle Optionen finden Sie unter src/index.ts .

🧑‍💻 Entwicklung

TypeScript-Quelle: src/index.ts
Aufbau: yarn build
Ausführen: node dist/index.js

📝 Lizenz

MIT

🩺 Fehlerbehebung

Stellen Sie sicher, dass Ihr OPENAI_API_KEY gültig ist und über Bild-API-Zugriff verfügt.
Sie müssen über eine verifizierte OpenAI-Organisation verfügen. Nach der Verifizierung kann es 15–20 Minuten dauern, bis der Bild-API-Zugriff aktiviert wird.
Dateipfade müssen absolut sein.
- Unix/macOS/Linux : Beginnend mit / (zB /path/to/image.png )
- Windows : Laufwerksbuchstabe gefolgt von : (zB C:/path/to/image.png oder C:\path\to\image.png )
Stellen Sie bei der Dateiausgabe sicher, dass das Verzeichnis beschreibbar ist.
Wenn Sie Fehler bezüglich der Dateitypen sehen, überprüfen Sie die Dateierweiterungen und -formate Ihrer Bilder.

⚠️ Einschränkungen und Handhabung großer Dateien

1-MB-Nutzlastlimit: MCP-Clients (einschließlich Claude Desktop) haben ein festes 1-MB-Limit für Tool-Antworten. Große Bilder (insbesondere hochauflösende oder mehrere Bilder) können dieses Limit leicht überschreiten, wenn sie als Base64 zurückgegeben werden.
Automatische Umstellung auf Dateiausgabe: Wenn die Gesamtbildgröße 1 MB überschreitet, speichert das Tool die Bilder automatisch auf der Festplatte und gibt den/die Dateipfad(e) anstelle von Base64 zurück. Dies gewährleistet die Kompatibilität und verhindert Fehler wie result exceeds maximum length of 1048576 .
Standarddateispeicherort: Wenn Sie keinen file_output angeben, werden Bilder unter einem eindeutigen Dateinamen in /tmp (oder dem durch die Umgebungsvariable MCP_HF_WORK_DIR festgelegten Verzeichnis) gespeichert.
Umgebungsvariable:
- MCP_HF_WORK_DIR : Legen Sie dies fest, um zu steuern, wo große Bilder und Dateiausgaben gespeichert werden. Beispiel: export MCP_HF_WORK_DIR=/your/desired/dir
Best Practice: Verwenden Sie für große Bilder oder Produktionsbilder immer die Dateiausgabe und stellen Sie sicher, dass Ihr Client für die Verarbeitung von Dateipfaden konfiguriert ist.