@qmediat.io/ideogram-mcp

MCP-Server für die Ideogram V3 API — zum Generieren, Bearbeiten, Remixen, Hochskalieren und Beschreiben von Bildern über Claude Code, Claude Desktop oder einen beliebigen MCP-Client.

Warum dieser Server?

• 7 Tools — vollständige Ideogram-V3-Abdeckung (generate, edit, remix, reframe, replace background, upscale, describe)

• Sicherheit zuerst — SSRF-Schutz, Symlink-Ablehnung, Content-Type-Validierung, Schutz vor Pfad-Traversierung, Zod-Response-Validierung (Details)

• 2 Laufzeitabhängigkeiten — @modelcontextprotocol/sdk + zod. Kein axios, kein form-data, keine HTTP-Bibliotheken

• Native Ideogram-API — direkte V3-Endpunkte, nicht über fal.ai oder Replicate weitergeleitet

• Für die Produktion gehärtet — Wiederholung mit exponentiellem Backoff, Safety-Filter-Handling, Resilienz bei Teilausfällen

Related MCP server: ideogram-mcp-server

Schnellstart

npm install -g @qmediat.io/ideogram-mcp

Oder direkt verwenden:

npx @qmediat.io/ideogram-mcp

IDEOGRAM_API_KEY ist erforderlich — einen erhalten Sie auf ideogram.ai/manage-api.

Konfiguration

Claude Code

Fügen Sie zu ~/.claude.json → mcpServers hinzu:

{
  "ideogram": {
    "command": "npx",
    "args": ["-y", "@qmediat.io/ideogram-mcp"],
    "env": {
      "IDEOGRAM_API_KEY": "your-api-key",
      "IDEOGRAM_OUTPUT_DIR": "/tmp/ideogram-output"
    }
  }
}

Claude Desktop

Fügen Sie zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "ideogram": {
      "command": "npx",
      "args": ["-y", "@qmediat.io/ideogram-mcp"],
      "env": {
        "IDEOGRAM_API_KEY": "your-api-key",
        "IDEOGRAM_OUTPUT_DIR": "/tmp/ideogram-output"
      }
    }
  }
}

Umgebungsvariablen

Verfügbare Tools

Allgemeine Parameter

Sicherheit

Dieser Server ist mit einem Zero-Trust-Ansatz und minimalen Abhängigkeiten konzipiert:

• SSRF-Schutz — Nur-HTTPS-Downloads, Hostname-Allowlist, Blockierung von Weiterleitungen

• Symlink-Ablehnung — lstat() lehnt vom Benutzer erstellte Symlinks vor dem Lesen ab

• Content-Type-Validierung — Downloads müssen image/* sein; HTML/JSON-Fehlerseiten werden abgelehnt

• Zod-Response-Validierung — API-Antworten werden über Schemas geparst, keine blinden Typumwandlungen

• Schutz vor Pfad-Traversierung — Erweiterungs-Allowlist + Containment-Prüfung mit path.relative()

Alle Details in SECURITY.md.

Entwicklung

git clone https://github.com/qmediat/ideogram-mcp.git
cd ideogram-mcp
npm install
npm run build

Lokal ausführen:

IDEOGRAM_API_KEY=your-key node dist/index.js

Mitwirken

Siehe CONTRIBUTING.md für Architekturrichtlinien und PR-Anforderungen.

Lizenz

MIT — Quantum Media Technologies