openai-gpt-image-mcp

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.

🚀 Installation

🔑 Konfiguration

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

⚡ 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.

📚 Referenzen

• OpenAI Images API-Dokumentation

🙏 Credits

• Erstellt mit @modelcontextprotocol/sdk

• Verwendet OpenAI Node.js SDK

• Erstellt von SureScale.ai