imaginate-mcp

Ein MCP-Server, der mit OpenAI GPT Image und Google Gemini (Nano Banana) Bilder generiert und bearbeitet. Er läuft über stdio, speichert jedes Bild auf der Platte und gibt den Dateipfad zurück, damit Ihr Assistder weiter das Ergebnis bearbeiten können.

Was Sie bekommen

Sechs Tools, nach Anbieter aufgeteilt:

Es werden nur die Tools registriert, für die Sie Schlüssel für konfigurierten Anbieter haben. Wenn Sie OPEANAI_KEY und sonst nichts setzen, sieht Ihr Assistent drei Tools, und keines davon kann auf Grund eines fehlenden Google-Schlüssels fehlschlagen. Das war auch nicht der Grund, die Tools nach Anbieter aufzuteilen statt ein ärtliches Tool mit provider-Argument zu nehmen, sondern?

Related MCP server: MCP OpenAI Image Generation Server

Voraussetzungen

• Node.js 20 oder neuer

• Ein OpenAI-API-Schlüssel, ein Gem+API key oder beides

GPT-Image-Modelle benötigen eine OpenAI-API-Organisationsverifizierung. Wenn Sie das nicht getan haben, lehnt OpenAI die Anfrage ab und der Server teilt Ihnen das mit.

Verbindung

Führen Sie das veröffentlichte Paket mit npx aus. Sie müssen weder das Repoortorium klonen noch das Paket global installieren.

npx -y @pinkpixel/imaginate-mcp

Fügen Sie den Server zur Konfiguration Ihres Clients. Für Claude Desktop bearbeiten Sie claude_desktop_config.json. Für Claude Code verwenden Sie .mcp.json in Ihrem Project oder in den Benutzereinstellungen.

{
  "mcpServers": {
    "imaginate": {
      "command": "npx",
      "args": ["-y", "@pinkpixel/imaginate-mcp"],
      "env": {
        "OPENAI_API_KEY": "sk-...",
        "GEMINI_API_KEY": "...",
        "IMAGINATE_OUTPUT_DIR": "~/Pictures/imaginate"
      }
    }
  }
}

Starten Sie den Client nach der Konfiguration neu. Wenn keine Bild-Tools erscheinen, rufen Sie imaginate_setup_help auf. Dieses Tool existiert nur, wenn kein Schüssel gefunden wurde, und listet die Variablen auf, die noch gesetzt werden müssen.

Aus dem Quellcode ausführen

Wenn Sie lokal auf dem Server arbeiten wollen, klonen und bauen Sie das Repository:

git clone https://github.com/pinkpixel-dev/imaginate-mcp.git
cd imaginate-mcp
npm install
npm run build
node dist/index.js

Um einen MCP-Client mit diesem Build zu verbinden, verwenden Sie "command": "node" und als args das absolute Pf ad zu dist/index.js.

Konfiguration

Weit den Server beim Starten alle Variablen einmal, die vom Server beders unterschieden; deshalb den Client nach der Änderung neu starten.

Jedes Tool kan den Ausgabepfad mit output_dir und filename bzw. übersteuern.

Dateien

Bilder gehen in das Ausgabeverzeichnis. Der Server überschreibt nie Dateien. Eine Datei cat.png, die existiert, wird zu cat-1.png und dann zu cat-2.png.

Standardnnamen sehen: [NA] openai-a-red-fox-20260825-134512-071.png. Das ist der Provider, die prompt-oriented. Geben Sie filename, um den Bilderbenennung zu ändhern.

Für Änderungen müssen Quellbilds lokale Dateien. Verwenden Sie absolute Pfade; die Tools laden keine URL. Laden Sie Dateien aus dem Web zuerst herunter und änderts nie herkunft?

Verwendung

Sobald das Server ist verbunden, du meist normal mit Ihrem Assistant arbeit. Einiges weiß möglich.

Auswahl des Anbieterers

Jeder Anbieter ist je nach Anforderungen. Gemini ist bei besseren Text-Bildern, Weltwissen und Infografiken? Es unterzeugen/Stützen mit der Google-Suche real. Es gibt eine interaction-ID, damit Sie die Weit verändern ohne wieder hochzuladen.

GPT Image folgt detailierten Layoutaufgaben und nimmt. It gibt feine Steuerung von Größe, Qualität, Background. Für transparent Hintergrund, aber Sie brauchen die gpt-image-1.5 oder älter, weil gpt-image-2 das nicht kann.

Gemini iterativ / wiederhole

Jedes Gemini-Ergebnis enthält die Interaktions-ID. Interaktions ID as previous_interaction_id and with another edit:

1. gemini_generate_image as prompt. Gemini gives you an Interaction ID.

2. gemini_edit_image with previous_interaction_id and a prompt like „make it landscape".

Das spart erneut hochladen– und das Bild bleibt in den Durchgängen gleich.

Bearbeiten & Zusammenstellen

Beide *_edit_image-ools sind zwei Aufgaben: nimm ein Bild-Pfad und ändern Sie, oder mehrere Pfad-Komposit.

Inpainting: OpenAI benet us Las. Gemini semantic: sagen Sie z.B. „den Himmel ändern, nicht den Rest und keine Mask".

Referenz-Kappen? Gemini: Lite 14, Nano 2:10, Pro 6. Übrigens shell ist ti.

Development

npm run build      # compile to dist/
npm run watch      # compile on change
npm run typecheck  # types only, no output
npm test           # compile tests and run them

Teste verwenden Node.JS. Sie prüfen Dateilname, Speicher, Gemini-Antwort, Zuweisung von msg. Kein API – tests ohne API überall.

Arbeit

src/
  index.ts               entry point, conditional tool registration
  config.ts              environment parsing
  lib/                   file handling, errors, result formatting, model catalog
  providers/openai/      OpenAI client wrapper and tool definitions
  providers/google/      Gemini client wrapper and tool definitions
tests/

Beegrenz

• Lokale Dateien nur, keine URL.

• Kein Streaming oder Teilbilder. Eine Antwort kommt nach dem Abschluss.

• Gemani „nicht noch" Nummer: Sie as one per call; OpenAI n be arbeitet.

• OpenAI benötigt complex bis to seconden? Neue bis two minutes. Preise.

• Gemini watermark SynthID.

• Beide Provider schnell verändert Preise / Modelle. Liste-ools beschreibungen.

Lizenz

Apache 2.0. Siehe LICENSE.

Mit 💖 erstellt von Pink Pixel apache.