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

Related MCP server: Image Generation MCP Server

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

1. Nur der prompt -Parameter ist erforderlich

2. Alle optionalen Parameter verwenden Standardwerte, wenn sie nicht angegeben sind.

3. Wenn Parameter angegeben werden, müssen sie ihren Einschränkungen entsprechen (z. B. Breiten-/Höhenbereiche).

4. Base64-Antworten können groß sein. Verwenden Sie das URL-Format für größere Bilder.

5. 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:

1. Forken Sie das Repository

2. Erstellen Sie einen neuen Zweig ( feature/my-new-feature )

3. Übernehmen Sie Ihre Änderungen

4. Schieben Sie den Zweig zu Ihrer Gabel

5. Ö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.