claude-foundry-image

Claude Code-Plugin, das jedem Projekt und jeder Konversation einen Bildgenerator hinzufügt, der auf Ihrer eigenen Azure AI Foundry-Bereitstellung basiert (MAI-Bild-API, z. B. MAI-Image-2.5-Pro).

• MCP-Server (server/server.mjs) — Node ≥ 18, null Abhängigkeiten. Tools: generate_image, edit_image, check_config.

• Skill generate-image — lehrt Claude, wann die Tools eingesetzt werden sollen, wie ein Einzeiler zu einem brauchbaren Prompt erweitert wird, gültige Abmessungen, wohin Dateien geschrieben werden.

• Skill setup — einmalige Konfigurationsanleitung.

Bilder werden auf die Festplatte geschrieben; nur der Dateipfad gelangt in die Konversation. Kein Base64 im Kontext.

Installieren

claude plugin marketplace add jpaarhuis/claude-foundry-image

claude plugin install foundry-image@jpaarhuis

Oder in einer interaktiven Sitzung: /plugin → Marktplätze → jpaarhuis/claude-foundry-image hinzufügen → foundry-image installieren.

Related MCP server: gpt-image-mcp

Konfigurieren (einmalig)

Der Server liest seine Einstellungen aus Umgebungsvariablen. Fügen Sie sie in ~/.claude/settings.json unter env ein — eine Datei, alle Plattformen, nur Claude Code sieht sie:

{
  "env": {
    "MAI_IMAGE_ENDPOINT": "https://<resource>.services.ai.azure.com/mai/v1/images/generations",
    "MAI_IMAGE_DEPLOYMENT": "MAI-Image-2.5-Pro",
    "MAI_IMAGE_API_KEY": "<key>",
    "MAI_IMAGE_OUTPUT_DIR": "C:/Users/<you>/Pictures/ai"
  }
}

Oder setzen Sie sie als Benutzerumgebungsvariablen des Betriebssystems (setx unter Windows, export in Ihrem Shell-Profil unter macOS/Linux). Starten Sie Claude Code in beiden Fällen neu.

Führen Sie dann in einer beliebigen Sitzung Folgendes aus: "run check_config" oder /foundry-image:setup für eine geführte Durchführung.

Verwenden

Fragen Sie einfach: "Erstelle ein Hero-Bild für die README, dunkel, isometrisch, kein Text". Claude erweitert den Prompt, wählt Abmessungen aus, schreibt das PNG (in das Repository, wenn es dorthin gehört) und gibt den Pfad zurück.

Tool-Parameter als Referenz:

Abmessungsregeln der MAI-API: jede Seite ≥ 768 px und Breite × Höhe ≤ 1 048 576 px. Also funktionieren 1024x1024, 1024x768, 1280x800; 1024x1536 und 1920x1080 nicht.

Warum Umgebungsvariablen und keine Konfigurationsdatei oder ein Einrichtungsdialog?

Claude Code-Plugins haben keinen pro-Plugin-Speicher für Geheimnisse oder eine Einrichtungsoberfläche. Die Konvention — dieselbe, die das offizielle GitHub-Plugin für sein PAT verwendet — ist die ${VAR}-Erweiterung in der .mcp.json des Plugins, wobei der Benutzer die Variablen einmal setzt. settings.json → env ist der Ort mit dem geringsten Reibungsverlust dafür: Es reist mit Ihrem Claude Code-Profil, gilt für jedes Projekt und überlebt Plugin-Updates.

Wenn Sie den Schlüssel aus Klartextdateien heraushalten möchten, laden Sie ihn bei der Anmeldung aus einem Geheimnisspeicher in die Umgebung (Key Vault, 1Password CLI, Windows Credential Manager) — dem Server ist es egal, woher die Variable kommt.

Entwickeln

npm test

Führt einen Offline-Smoke-Test durch: MCP-Handshake, Tool-Auflistung, Dimensionsprüfungen, Fehler bei fehlender Konfiguration und prüft, dass check_config niemals einen Schlüssel preisgibt.

Lizenz

MIT