README.md

🚀 Magnific MCP

Model Context Protocol Server für Magnific AI – Bilder generieren und in Videos umwandeln mit KI-Power

🎯 Features

• 🎨 Image Creation – Bilder mit Mystic, Flux Pro, Flux Dev generieren
• 🎬 Image-to-Video – Bilder mit Kling v2 in Videos umwandeln
• ⏱️ Async Task Management – Fortschritt von Generierungen tracken
• ⚡ FastMCP – Optimiert für Claude und andere AI Assistants

📋 Voraussetzungen

• Python 3.12+
• uv Dependency Manager (install)
• Magnific API Key (get here)

🛠️ Installation

1. Repository klonen

git clone https://github.com/MikeHillebrandMedia/magnific-mcp.git
cd magnific-mcp

2. Dependencies installieren

make install
# oder
uv sync

3. API Key konfigurieren

# Option A: Environment Variable
export MAGNIFIC_API_KEY=your_key_here

# Option B: .env Datei
cp .env.dist .env
# Bearbeite .env und füge deinen Key ein

⚙️ Claude Code Setup

Füge dies zu deiner ~/.claude/mcp.json hinzu:

{
  "mcpServers": {
    "magnific-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/Users/mikehillebrandmedia/.claude/magnific-mcp",
        "main.py"
      ],
      "env": {
        "MAGNIFIC_API_KEY": "your_api_key_here"
      }
    }
  }
}

Dann Claude Code neu starten! 🔄

📚 Verfügbare Tools

🎨 create_image

Generiere Bilder mit Text-Prompts

Parameter:

Param	Typ	Default	Beschreibung
prompt	string	-	Bildbeschreibung
model	string	mystic	Model: mystic, flux-pro, flux-dev
cfg_scale	float	7.5	Guidance Scale (0-20)
negative_prompt	string	""	Was vermieden werden soll

Beispiel:

Generiere ein Bild von einem Sonnenuntergang über den Bergen mit Flux Pro

---

🎬 create_video_from_image

Konvertiere Bilder zu Videos mit Kling v2

Parameter:

Param	Typ	Default	Beschreibung
image_url	string	-	URL des Bildes
prompt	string	""	Bewegungsbeschreibung
duration	string	"5"	Video-Länge: "5" oder "10" Sekunden
cfg_scale	float	0.5	Flexibilität (0-1)
negative_prompt	string	""	Was vermieden werden soll

Beispiel:

Konvertiere dieses Bild zu einem 10-Sekunden Video mit sanften Bewegungen

---

⏱️ get_task_status

Checke den Status einer Generierung

Parameter:

Param	Typ	Beschreibung
task_id	string	Task ID aus create_image oder create_video_from_image

Rückgabe:

• status – "pending", "processing", "completed", oder "failed"
• result – Download-URLs wenn fertig
• progress – Fortschritt in Prozent (wenn verfügbar)

🚀 Verwendung

Development Mode

make dev

Production Mode

make run

Code Quality

make clean

💡 Tipps

• Asynchrone Verarbeitung: Generierungen laufen async – nutze get_task_status zum Tracken
• Bild-URLs: Für Image-to-Video müssen Bilder öffentlich zugänglich sein
• Rate Limits: Max. 3 parallele Anfragen pro User
• Bildformat: PNG/JPG, min. 300x300px, max. 10MB

🔗 Links

• Magnific Docs
• API Reference
• GitHub Repository

📝 Troubleshooting

"MAGNIFIC_API_KEY environment variable is required"

→ Prüfe deine .env Datei oder export MAGNIFIC_API_KEY=...

"Permission denied" bei GitHub Push

→ Nutze Personal Access Token statt Passwort

Video-Generierung schlägt fehl

→ Stelle sicher, dass die Bild-URL öffentlich zugänglich ist

📄 License

MIT – Mach damit, was du willst! 🎉

---

Made with ❤️ für schnellere KI-Content-Erstellung

Questions? Open an issue on GitHub!