🎨 pruna-mcp-server

MCP-Server für Pruna AI — ultraschnelle Bildgenerierung, Bearbeitung, Upscaling und Videogenerierung direkt aus Ihrem KI-Assistenten.

Pruna AI ist eine Inference-API, die auf Bild- und Videogenerierung spezialisiert ist. Sie bietet Bildgenerierung in unter 2 Sekunden ab 0,005 $/Bild, mit Modellen für Text-zu-Bild, Bildbearbeitung, Upscaling und Videogenerierung. Dieser MCP-Server kapselt deren API, sodass jeder MCP-kompatible Client (Claude Desktop, Kiro, Cursor) visuelle Inhalte nativ generieren kann.

Entspricht der MCP-Spezifikation 2025-11-25.

Funktionen

• 6 MCP-Tools: generate_image, edit_image, upscale_image, generate_video, list_models, upload_file

• 7 MCP-Prompts: Produktfotos, virtuelles Staging, Social-Media-Visuals, Spiel-Konzeptkunst, Werbeanzeigen, Videoanzeigen, Bildverbesserung

• 2 MCP-Ressourcen: pruna://models-Katalog zur Modellsuche ohne Tool-Aufrufe

• 18 Modelle: 10 Text-zu-Bild, 3 Bearbeitung, 1 Upscale, 4 Video

• Smart Sync/Async: Synchron für schnelle Bildmodelle, asynchron mit Polling für Videos

• Transparente Dateiverarbeitung: Lokale Pfade oder URLs übergeben — automatischer Upload wird gehandhabt

• Native MCP-Bildrückgabe: ImageContent-Blöcke für Clients, die Inline-Anzeige unterstützen

• Volle MCP-Konformität: Tool-Annotationen, strukturierte Inhalte, Fortschrittsbenachrichtigungen

Schnellstart

# With uvx (zero install)
uvx pruna-mcp-server

# Or with pip
pip install pruna-mcp-server
pruna-mcp

Legen Sie Ihren API-Schlüssel fest — erhalten Sie einen unter pruna.ai (besuchen Sie das Entwicklerportal oder kontaktieren Sie Pruna, um Zugriff anzufordern):

# macOS Keychain (recommended)
security add-generic-password -a $USER -s PRUNA_API_KEY -w "your-api-key"

# Or environment variable
export PRUNA_API_KEY="your-api-key"

MCP-Client-Konfiguration

Kiro CLI

Fügen Sie dies zu Ihrer Agenten-Konfiguration hinzu (z. B. ~/.kiro/agents/default.json):

In mcpServers:

"pruna": {
  "command": "sh",
  "args": ["-c", "PRUNA_API_KEY=$(security find-generic-password -a $USER -s PRUNA_API_KEY -w) uv run --directory /path/to/pruna-mcp-server pruna-mcp"],
  "autoApprove": ["generate_image", "edit_image", "upscale_image", "generate_video", "list_models", "upload_file"]
}

Fügen Sie in tools hinzu: "@pruna/*"

Fügen Sie in allowedTools hinzu: "generate_image", "edit_image", "upscale_image", "generate_video", "list_models", "upload_file"

Hinweis: Kiro-Agenten verwenden eine tools-Whitelist mit der Syntax @server-name/* und eine allowedTools-Liste. Beide müssen die Pruna-Tools enthalten, damit diese verfügbar sind.

Claude Desktop

Fügen Sie dies zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) hinzu:

{
  "mcpServers": {
    "pruna": {
      "command": "sh",
      "args": ["-c", "PRUNA_API_KEY=$(security find-generic-password -a $USER -s PRUNA_API_KEY -w) /path/to/uv run --directory /path/to/pruna-mcp-server pruna-mcp"]
    }
  }
}

Wichtig: Verwenden Sie den vollständigen Pfad zu uv (z. B. /Users/you/.local/bin/uv) — Claude Desktop startet Prozesse mit einem minimalen PATH, der ~/.local/bin nicht enthält.

Hinweis: Claude Desktop rendert ImageContent nicht inline im Chat. Das Bild wird generiert und lokal gespeichert — Claude wird den Dateipfad in seiner Antwort referenzieren.

Cursor

Fügen Sie dies zu .cursor/mcp.json hinzu:

{
  "mcpServers": {
    "pruna": {
      "command": "uvx",
      "args": ["pruna-mcp-server"],
      "env": { "PRUNA_API_KEY": "your-api-key" }
    }
  }
}

Tools

Bild-Tools geben sowohl einen JSON-Metadatenblock als auch einen nativen MCP-ImageContent-Block zurück (base64, für Bilder < 5 MB).

Prompts

Integrierte Workflow-Vorlagen für häufige Anwendungsfälle:

Konfiguration

Client-Kompatibilität

Entwicklung

git clone https://github.com/charlesrapp/pruna-mcp-server.git
cd pruna-mcp-server
uv sync --extra dev

# Run tests (100 tests, 94% coverage)
uv run pytest --cov

# Lint & type check
uv run ruff check src/ tests/
uv run mypy src/

Siehe CONTRIBUTING.md für Richtlinien.

Lizenz

MIT — siehe LICENSE.