MCP-Server zur Bildgenerierung

Ein Model Context Protocol (MCP)-Server, der die nahtlose Generierung hochwertiger Bilder mithilfe des Flux.1 Schnell-Modells über Together AI ermöglicht. Dieser Server bietet eine standardisierte Schnittstelle zur Angabe von Bildgenerierungsparametern.

Merkmale

Hochwertige Bilderzeugung durch das Flux.1 Schnell-Modell
Unterstützung für anpassbare Abmessungen (Breite und Höhe)
Klare Fehlerbehandlung für schnelle Validierung und API-Probleme
Einfache Integration mit MCP-kompatiblen Clients
Optionales Speichern des Bildes auf der Festplatte im PNG-Format

Installation

npm install together-mcp

Oder führen Sie direkt aus:

npx together-mcp@latest

Konfiguration

Fügen Sie Ihrer MCP-Serverkonfiguration hinzu:

{
  "mcpServers": {
    "together-image-gen": {
      "command": "npx",
      "args": ["together-mcp@latest -y"],
      "env": {
        "TOGETHER_API_KEY": "<API KEY>"
      }
    }
  }
}

Verwendung

Der Server stellt ein Tool bereit: generate_image

Verwenden von generate_image

Dieses Tool verfügt nur über einen obligatorischen Parameter: die Eingabeaufforderung. Alle anderen Parameter sind optional und verwenden sinnvolle Standardwerte, falls sie nicht angegeben werden.

Parameter

{
  // Required
  prompt: string;          // Text description of the image to generate

  // Optional with defaults
  model?: string;          // Default: "black-forest-labs/FLUX.1-schnell-Free"
  width?: number;          // Default: 1024 (min: 128, max: 2048)
  height?: number;         // Default: 768 (min: 128, max: 2048)
  steps?: number;          // Default: 1 (min: 1, max: 100)
  n?: number;             // Default: 1 (max: 4)
  response_format?: string; // Default: "b64_json" (options: ["b64_json", "url"])
  image_path?: string;     // Optional: Path to save the generated image as PNG
}

Minimales Anforderungsbeispiel

Es ist lediglich die Eingabeaufforderung erforderlich:

{
  "name": "generate_image",
  "arguments": {
    "prompt": "A serene mountain landscape at sunset"
  }
}

Vollständiges Anforderungsbeispiel mit Bildspeicherung

Überschreiben Sie alle Standardeinstellungen und geben Sie einen Pfad zum Speichern des Bilds an:

{
  "name": "generate_image",
  "arguments": {
    "prompt": "A serene mountain landscape at sunset",
    "width": 1024,
    "height": 768,
    "steps": 20,
    "n": 1,
    "response_format": "b64_json",
    "model": "black-forest-labs/FLUX.1-schnell-Free",
    "image_path": "/path/to/save/image.png"
  }
}

Antwortformat

Die Antwort ist ein JSON-Objekt mit folgendem Inhalt:

{
  "id": string,        // Generation ID
  "model": string,     // Model used
  "object": "list",
  "data": [
    {
      "timings": {
        "inference": number  // Time taken for inference
      },
      "index": number,      // Image index
      "b64_json": string    // Base64 encoded image data (if response_format is "b64_json")
      // OR
      "url": string        // URL to generated image (if response_format is "url")
    }
  ]
}

Wenn der Bildpfad angegeben wurde und das Speichern erfolgreich war, enthält die Antwort eine Bestätigung des Speicherorts.

Standardwerte

Wenn in der Anfrage nichts anderes angegeben ist, werden diese Standardwerte verwendet:

Modell: "black-forest-labs/FLUX.1-schnell-Free"
Breite: 1024
Höhe: 768
Schritte: 1
n: 1
Antwortformat: "b64_json"

Wichtige Hinweise

Nur der prompt -Parameter ist erforderlich
Alle optionalen Parameter verwenden Standardwerte, wenn sie nicht angegeben sind.
Wenn Parameter angegeben werden, müssen sie ihren Einschränkungen entsprechen (z. B. Breiten-/Höhenbereiche).
Base64-Antworten können groß sein. Verwenden Sie das URL-Format für größere Bilder.
Stellen Sie beim Speichern von Bildern sicher, dass das angegebene Verzeichnis vorhanden und beschreibbar ist

Voraussetzungen

Node.js >= 16
Together AI API-Schlüssel
1. Melden Sie sich bei api.together.xyz an
2. Navigieren Sie zu den API-Schlüsseleinstellungen
3. Klicken Sie auf „Erstellen“, um einen neuen API-Schlüssel zu generieren
4. Kopieren Sie den generierten Schlüssel zur Verwendung in Ihrer MCP-Konfiguration

Abhängigkeiten

{
  "@modelcontextprotocol/sdk": "0.6.0",
  "axios": "^1.6.7"
}

Entwicklung

Klonen und erstellen Sie das Projekt:

git clone https://github.com/manascb1344/together-mcp-server
cd together-mcp-server
npm install
npm run build

Verfügbare Skripte

npm run build – Erstellen Sie das TypeScript-Projekt
npm run watch - Auf Änderungen achten und neu erstellen
npm run inspector – MCP-Inspektor ausführen

Beitragen

Beiträge sind willkommen! Bitte folgen Sie diesen Schritten:

Forken Sie das Repository
Erstellen Sie einen neuen Zweig ( feature/my-new-feature )
Übernehmen Sie Ihre Änderungen
Schieben Sie den Zweig zu Ihrer Gabel
Öffnen einer Pull-Anfrage

Funktionsanfragen und Fehlerberichte können über GitHub Issues eingereicht werden. Bitte prüfen Sie bestehende Issues, bevor Sie ein neues erstellen.

Bei wesentlichen Änderungen öffnen Sie bitte zunächst ein Problem, um Ihre Änderungsvorschläge zu besprechen.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Weitere Informationen finden Sie in der Datei LICENSE.

Image Generation MCP Server

Integrations