RelayOne Image MCP

Dies ist das MCP-Integrationspaket für RelayOne Image, das sowohl die Image2- als auch die Gemini-Banana-Bildgenerierungsrouten unterstützt. Jeder Benutzer muss nur einen RelayOne-API-Key konfigurieren.

Zwei Bildgenerierungs-Provider

Banana unterstützt außerdem gemini-3-pro-image. Dessen imageSize sind die Klarheitsstufen 512, 1K, 2K, 4K, während aspectRatio das Seitenverhältnis steuert; es handelt sich nicht um das feste Breite x Höhe-Größenprotokoll von Image2.

Related MCP server: Gemini Image Generation MCP Server

Unterstützte Modelle

Image2

Gemini Banana

gemini-3-pro-image-preview wird zu gemini-3-pro-image normalisiert und ist ein Alias, kein drittes unabhängiges Modell. Beide Banana-Modelle rufen für Text-zu-Bild und Bild-zu-Bild dieselbe generateContent-Schnittstelle auf; ob reference_images mitgeführt werden, entscheidet, ob es sich um Text-zu-Bild oder Bild-zu-Bild handelt.

Nach Auswahl des Providers wählt das MCP automatisch das Protokoll:

• image2 ruft ohne reference_images das JSON von /v1/images/generations auf; mit Referenzbildern wird /v1/images/edits als Multipart aufgerufen und die Referenzbilder werden als image[] hochgeladen.

• banana ruft immer /v1beta/models/{model}:generateContent auf; Referenzbilder werden in contents[].parts[].inlineData konvertiert, nicht als Multipart und nicht als OpenAI-Images-JSON.

Was auf der Website ausgefüllt werden muss

1. config/providers.json enthält bereits die RelayOne-Adresse, Modelle und den Images-Pfad; zum Wechseln der Website muss diese Datei geändert werden.

2. Jeder Agent kopiert .env.example zu .env und füllt nur SITE_IMAGE_API_KEY aus; der Key darf nicht in Tool-Parameter geschrieben werden.

3. Falls ein Proxy benötigt wird, muss auf dem Rechner, der das MCP ausführt, zusätzlich SITE_IMAGE_PROXY_URL gesetzt werden. Dies ist optional.

4. Falls die Website keine Bearer-Authentifizierung verwendet oder kein OpenAI-kompatibles Anfrageformat hat, muss die Anpassungslogik in callProvider und im Anfrage-Schema in src/index.ts geändert werden.

5. npm install und npm run build ausführen und dann dist/index.js im MCP-Client registrieren.

.env wird beim MCP-Start automatisch gelesen, daher muss der Agent den Startbefehl nicht ändern.

MCP-Registrierungsbeispiel

Ersetze PACKAGE_DIRECTORY in mcp-server.example.json durch das aktuelle Paketverzeichnis und registriere es dann im Konfigurationsformat des verwendeten MCP-Clients. .env und dist/index.js müssen sich auf derselben Ebene wie dieses Verzeichnis befinden.

Tools

• list_image_providers: Zeigt die lokal konfigurierten Kanäle an, ohne Schlüssel anzuzeigen.

• list_remote_image_models: Liest die Echtzeit-Modellliste, generiert keine Bilder.

• get_image_capabilities: Zeigt die vom Website-Betreiber ausgefüllten Parameterfähigkeiten an.

• get_image_usage: Liest die optionale Nutzungsschnittstelle, generiert keine Bilder.

• prepare_image_request: Vorschau des tatsächlichen JSON, ohne Netzwerkverbindung.

• generate_image: Vor dem Aufruf muss der lokale absolute Pfad save_directory angegeben werden. Das Tool behält das vollständige ursprüngliche Antwort-JSON (einschließlich url und b64_json) bei, speichert das Bild in diesem Verzeichnis und gibt gleichzeitig den MCP-image-Inhalt zurück.

Benutzerdefinierte Parameter pro Aufruf

Standardfelder werden direkt übergeben, website-spezifische Felder werden in custom_parameters eingefügt. Zum Beispiel:

{
  "prompt": "一座雨夜城市",
  "size": "1024x1024",
  "custom_parameters": {
    "steps": 30,
    "guidance_scale": 7,
    "seed": 12345,
    "negative_prompt": "模糊、低清晰度"
  }
}

custom_parameters werden in das Anfrage-JSON dieses Aufrufs eingefügt; provider, model, prompt, custom_parameters sowie bereits übergebene Standardfelder können nicht überschrieben werden.

Sicherheitsbeschränkungen

• Echte Schlüssel werden nur in die Startumgebung gelegt, nicht in providers.json, Code, Logs oder MCP-Tool-Parameter geschrieben.

• save_directory muss vom Benutzer vor jeder Bildgenerierung explizit ausgewählt werden; das MCP entscheidet nicht selbst über den Speicherort.

• Im Speicherverzeichnis wird eine .response.json-Originalantwortdatei sowie nummerierte Bilddateien erstellt.

• Der Download von URL-Bildern erlaubt nur HTTP(S) und ist auf 25 MB begrenzt; bei Downloadfehlern bleibt die ursprüngliche URL weiterhin in .response.json erhalten.

• Anfrage und Antwort geben keinen Authorization-Header aus.

• advanced-Durchreichung ist nicht in die Vorlage aufgenommen; der Website-Betreiber sollte Whitelist-Felder einzeln entsprechend seiner eigenen Schnittstelle hinzufügen.

Codex-Registrierung

Registriere node dist/index.js in der MCP-Konfiguration von Codex und übergebe den RelayOne-Key über die konfigurierten Umgebungsvariablen. Gib keine echten Werte in Beispieldateien oder an Dritte weiter.

Projektadresse: https://github.com/linshiqiyyds/relayone-image-mcp

Beispiel für den Bildgenerierungsaufruf

Beim Aufruf von generate_image muss zuerst ein Speicherverzeichnis ausgewählt werden, zum Beispiel:

{
  "prompt": "一只橘猫坐在窗边，电影感，自然光",
  "size": "1024x1024",
  "response_format": "b64_json",
  "save_directory": "D:\\RelayOne-MCP\\generated"
}

Wenn response_format: "url" gewählt wird, lädt das MCP das Bild von der URL herunter; bei b64_json dekodiert das MCP das Base64. Beide ursprünglichen Felder werden unverändert in der .response.json-Datei gespeichert.

Image2-Beispiel

{
  "provider": "image2",
  "model": "gpt-image-2",
  "prompt": "一张产品摄影图",
  "size": "2048x1152",
  "response_format": "url",
  "save_directory": "D:\\RelayOne-MCP\\generated"
}

Für Image2-Bild-zu-Bild muss nur der lokale Referenzbildpfad hinzugefügt werden; das MCP wechselt automatisch zu /v1/images/edits:

{
  "provider": "image2",
  "model": "gpt-image-2",
  "prompt": "保留主体，把背景改成夜晚城市",
  "reference_images": ["D:\\References\\product.png"],
  "size": "2048x1152",
  "save_directory": "D:\\RelayOne-MCP\\generated"
}

Banana-Beispiel

{
  "provider": "banana",
  "model": "gemini-3.1-flash-image",
  "prompt": "把产品放在夜晚城市街道中",
  "aspectRatio": "16:9",
  "imageSize": "2K",
  "reference_images": [
    "D:\\References\\product.png"
  ],
  "save_directory": "D:\\RelayOne-MCP\\generated"
}

Die Referenzbilder von Banana werden als reines Base64 gelesen und gemäß dem nativen Gemini-Protokoll in contents[].parts[].inlineData eingefügt. Maximal 14 Bilder, jeweils bis zu 20 MB, unterstützt PNG, JPEG, WebP. Die Banana-Modelle verwenden weder gpt-image-2 noch das feste Pixel-size-Feld von Image2.