openai-images-mcp

Generieren und bearbeiten Sie Bilder mit den gpt-image- und DALL·E-Modellen von OpenAI, bereitgestellt als Model Context Protocol-Werkzeuge. Unterstützt gpt-image-1.5, gpt-image-1, gpt-image-1-mini, dall-e-3 und dall-e-2.

Werkzeuge

Alle generierten Dateien werden auf der Festplatte gespeichert. Setzen Sie return_image_content: true bei jedem Aufruf, um die Bilder auch als MCP-Bildblöcke zu erhalten (nützlich, wenn der Client das Ergebnis "sehen" soll, verbraucht jedoch viele Token).

Installation

npm install
npm run build

Konfigurieren Sie Ihren MCP-Client

Claude Desktop / Claude Code

Fügen Sie dies zu claude_desktop_config.json (oder der .mcp.json Ihres Projekts) hinzu:

{
  "mcpServers": {
    "dalle": {
      "command": "node",
      "args": ["/absolute/path/to/dalle-mcp/dist/index.js"],
      "env": {
        "OPENAI_API_KEY": "sk-...",
        "DALLE_OUTPUT_DIR": "/absolute/path/where/images/save"
      }
    }
  }
}

Umgebungsvariablen

Werkzeugreferenz

generate_image

Erforderlich: prompt.

Optional: model, size, quality, n, background, output_format, output_compression, moderation, style, user, output_dir, filename_prefix, return_image_content.

Modellspezifische Hinweise:

• GPT Image (gpt-image-1.5, gpt-image-1, gpt-image-1-mini): Größen auto|1024x1024|1536x1024|1024x1536, Qualitäten auto|low|medium|high. Unterstützt background, output_format, output_compression, moderation.

• DALL·E 3: Größen 1024x1024|1792x1024|1024x1792, Qualitäten standard|hd, n muss 1 sein, unterstützt style.

• DALL·E 2: Größen 256x256|512x512|1024x1024, Qualität standard.

edit_image

Erforderlich: prompt, images (absolute Pfade, bis zu 16 für GPT Image).

Optional: mask (transparente Pixel zeigen bearbeitbare Bereiche an), plus die oben genannten Generierungsoptionen. DALL·E 3 unterstützt keine Bearbeitungen.

create_variation

Nur DALL·E 2. Erforderlich: image (PNG, quadratisch, unter 4 MB).

Optional: n, size (256x256|512x512|1024x1024), output_dir, filename_prefix, return_image_content.

list_models

Keine Argumente. Gibt ein JSON-Dokument zurück, das die Größen, Qualitäten und unterstützten Optionen jedes Modells beschreibt – praktisch für den Aufrufer, um sie vor der Auswahl der Parameter zu prüfen.

Entwicklung

npm run dev     # run with tsx, no build step
npm run build   # tsc to dist/
npm start       # node dist/index.js

Der Server spricht MCP über stdio, sodass Sie ihn mit jedem MCP-kompatiblen Client oder manuell durch Weiterleitung von JSON-RPC-Nachrichten an node dist/index.js steuern können.

Hinweise

• DALL·E 2 und DALL·E 3 sind von OpenAI als veraltet markiert und der Support endet am 12.05.2026; bevorzugen Sie die GPT Image-Familie.

• GPT Image-Modelle geben immer Base64-Daten zurück; DALL·E-Modelle werden ebenfalls nach Base64 gefragt, damit Dateien ohne einen zweiten HTTP-Roundtrip gespeichert werden können.