Skip to main content
Glama

Image Gen MCP

TypeScript-MCP-Server zum Generieren und Bearbeiten von Bildern über OpenAI-Bildmodelle.

Der Server registriert die Tools generate_image und edit_image und schreibt die zurückgegebenen Bildbytes auf die Festplatte. Im Stdio-Modus wird in den angeforderten absoluten Dateipfad geschrieben; bei SSE und streamable HTTP werden Dateien automatisch gespeichert und Bild-URLs zurückgegeben.

Umgebungsvariablen

Name

Erforderlich

Standard

Beschreibung

BASE_URL

Nein

AI SDK OpenAI-Standard

OpenAI-API-URL-Präfix, z. B. https://api.openai.com/v1. Root-URLs hängen automatisch /v1 an.

API_KEY

Ja

-

OpenAI-API-Schlüssel.

MODEL

Nein

gpt-image-2

OpenAI-Bildmodell.

FILE_DIR

Nein

./data

Verzeichnis für automatisch gespeicherte Dateien im SSE/HTTP-Modus. Docker setzt dies standardmäßig auf /data.

Related MCP server: OpenAI GPT-Image MCP Server

Tool

generate_image

Argumente:

Name

Erforderlich

Standard

Beschreibung

prompt

Ja

-

Bild-Prompt.

filepath

Stdio

-

Nur Stdio. Absoluter Ausgabepfad. Übergeordnete Verzeichnisse werden automatisch erstellt.

n

Nein

1

Anzahl der Bilder, von 1 bis 3.

size

Nein

auto

auto, 256x256, 512x512, 1024x1024, 1536x1024, 1024x1536, 1792x1024 oder 1024x1792.

quality

Nein

medium

low, medium, high oder auto.

background

Nein

-

transparent, opaque oder auto.

output_format

Nein

png

png, jpeg, jpg oder webp; jpg wird als jpeg gesendet.

output_compression

Nein

-

Komprimierungsstufe von 0 bis 100.

moderation

Nein

-

auto oder low.

overwrite

Stdio

false

Nur Stdio. Erlaubt das Ersetzen vorhandener Ausgabedateien.

Bekannte Modellgrößenlimits werden vor dem Aufruf der Upstream-API validiert. Beispielsweise unterstützen gpt-image-*-Modelle 1024x1024, 1536x1024 und 1024x1536; dall-e-2 unterstützt 256x256, 512x512 und 1024x1024.

Für n > 1 wird ein Dateipfad wie /tmp/image.png zu /tmp/image-1.png, /tmp/image-2.png usw.

Im SSE- und streamable-HTTP-Modus sind filepath und overwrite nicht verfügbar. Generierte Dateien werden unter ${FILE_DIR}/YYYY-MM-DD/<uuid>.<ext> gespeichert und mit URLs wie http://localhost:3000/file/YYYY-MM-DD/<uuid>.png zurückgegeben.

edit_image

Argumente:

Name

Erforderlich

Standard

Beschreibung

prompt

Ja

-

Bearbeitungsanweisung.

image_path

Ja

-

Absoluter Pfad zum Quellbild, das bearbeitet werden soll.

mask_path

Nein

-

Optionaler absoluter Pfad zum Maskenbild für die Bearbeitung.

filepath

Stdio

-

Nur Stdio. Absoluter Ausgabepfad. Übergeordnete Verzeichnisse werden automatisch erstellt.

n

Nein

1

Anzahl der bearbeiteten Bilder, von 1 bis 3.

size

Nein

auto

auto, 256x256, 512x512, 1024x1024, 1536x1024, 1024x1536, 1792x1024 oder 1024x1792.

quality

Nein

medium

low, medium, high oder auto.

background

Nein

-

Hintergrundverhalten des bearbeiteten Bildes.

output_format

Nein

png

png, jpeg, jpg oder webp; jpg wird als jpeg gesendet.

output_compression

Nein

-

Komprimierungsstufe von 0 bis 100.

moderation

Nein

-

auto oder low.

overwrite

Stdio

false

Nur Stdio. Erlaubt das Ersetzen vorhandener Ausgabedateien.

Das Tool ruft den OpenAI-kompatiblen /images/edits-Endpunkt mit Multipart-Formulardaten auf. Die Ausgabedateien folgen demselben Dateipfad- und Auto-Save-Verhalten wie generate_image.

Entwicklung

pnpm install
pnpm dev

Nützliche Prüfungen:

pnpm check
pnpm build

Stdio-MCP-Konfiguration

{
  "mcpServers": {
    "image-gen-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["image-gen-mcp"],
      "env": {
        "BASE_URL": "https://api.openai.com/v1",
        "API_KEY": "sk-...",
        "MODEL": "gpt-image-2"
      }
    }
  }
}

Streamable HTTP

{
  "mcpServers": {
    "image-gen-mcp": {
      "type": "http",
      "url": "http://localhost:3000/mcp",
      "headers": {
        "openai-base-url": "https://api.openai.com/v1",
        "openai-api-key": "sk-...",
        "openai-model": "gpt-image-2"
      }
    }
  }
}

Header überschreiben die serverseitige Env-Konfiguration; ohne sie werden die Env-Werte verwendet. Das Docker-Image startet streamable HTTP auf Port 3000.

SSE

Der SSE-Transport befindet sich in src/sse.ts und lauscht auf PORT (Standard 4000) unter /mcp, wobei Nachrichten an /message gesendet werden. Führen Sie ihn direkt mit pnpm start:sse aus; er wird nicht vom Docker-Image gestartet.

{
  "mcpServers": {
    "image-gen-mcp": {
      "type": "sse",
      "url": "http://localhost:4000/mcp",
      "headers": {
        "openai-api-key": "sk-..."
      }
    }
  }
}

Docker

docker build -t image-gen-mcp .
docker run --rm -p 3000:3000 \
  # 也可忽略apiKey,让使用方 headers 中传递
  -e BASE_URL=https://api.openai.com/v1 \
  -e API_KEY=sk-... \
  -e MODEL=gpt-image-2 \
  -v image-gen-data:/data \
  image-gen-mcp
Install Server
F
license - not found
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Generate AI images, video, music, and sound effects, and upscale them, from any MCP client.

  • LLM chat, text summarization and AI image generation

  • OCR, transcription, file extraction, and image generation for AI agents via MCP.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/seepine/image-gen-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server