Skip to main content
Glama

creatify-mcp

by TSavo

🎬 MCP-Server erstellen

Der ultimative MCP-Server für die KI-Videogenerierung – bringt die leistungsstarken Videoerstellungsfunktionen von Creatify AI zu jedem KI-Assistenten im MCP-Ökosystem.

🌟 Übersicht

Der Creatify MCP Server ist ein umfassender Model Context Protocol (MCP)-Server, der die volle Leistungsfähigkeit der Videogenerierungsplattform von Creatify AI für KI-Assistenten, Chatbots und Automatisierungstools nutzbar macht. Basierend auf der robusten TypeScript-Clientbibliothek @tsavo/creatify-api-ts wandelt dieser Server komplexe Videoerstellungs-Workflows in einfache, natürlichsprachliche Interaktionen um.

🎨 Erweiterte MCP-Funktionen:

  • 📝 Eingabeaufforderungen – Wiederverwendbare Vorlagen und Arbeitsabläufe zur Videoerstellung
  • 📊 Protokollierung – Strukturierte Protokollierung mit mehreren Schweregraden
  • 🔍 Fortschrittsverfolgung – Echtzeit-Updates während der Videogenerierung
  • 🤖 KI-Selbsthilfehow_to_use zum Verstehen von Parametern für KI-Assistenten
  • 📊 Benachrichtigungen - Statusaktualisierungen und Fortschrittsbenachrichtigungen in Echtzeit

🎯 Was dies ermöglicht

Stellen Sie sich vor, Sie sagen Claude Desktop: „Erstellen Sie ein 16:9-Avatar-Video von Anna, in dem sie ‚Willkommen zu unserer Produktdemo‘ sagt, und warten Sie, bis es abgeschlossen ist.“ Und tatsächlich passiert es. Das ist die Stärke dieses MCP-Servers.

🏗️ Erstellt mit

Merkmale

🛠️ MCP-Tools (12 leistungsstarke Aktionen)

  • create_avatar_video – Erstellen Sie KI-Avatar-Videos mit Lippensynchronisation
  • create_url_to_video - Konvertieren Sie Websites in professionelle Videos
  • generate_text_to_speech - Natürlich klingende Sprache aus Text generieren
  • create_multi_avatar_conversation – Erstellen Sie Videos mit mehreren Avataren, die sich unterhalten
  • create_custom_template_video – Videos mit benutzerdefinierten Vorlagen erstellen
  • create_ai_edited_video – Videos automatisch bearbeiten und verbessern
  • create_ai_shorts – Erstellen Sie Kurzvideos (perfekt für TikTok, Instagram Reels)
  • generate_ai_script – KI-gestützte Skripte für Videos generieren
  • create_custom_avatar – Entwerfen und erstellen Sie Ihre eigenen benutzerdefinierten Avatare (DYOA)
  • manage_music - Hintergrundmusik hochladen, verwalten und verwenden
  • create_advanced_lipsync – Erweiterte Lippensynchronisation mit Emotions- und Gestensteuerung
  • how_to_use - Erhalten Sie detaillierte Nutzungsinformationen für jedes Tool
  • get_video_status – Überprüfen Sie den Status der Videogenerierungsaufgaben

📚 MCP-Ressourcen (6 Datenquellen)

  • creatify://avatars – Liste der verfügbaren KI-Avatare
  • creatify://voices - Liste der verfügbaren Stimmen für Text-to-Speech
  • creatify://templates - Verfügbare benutzerdefinierte Videovorlagen
  • creatify://music - Verfügbare Hintergrundmusikbibliothek
  • creatify://credits – Verbleibende API-Guthaben
  • creatify://avatar/{avatarId} – Detaillierte Informationen zu bestimmten Avataren

🏆 Warum sollten Sie sich für den Creatify MCP-Server entscheiden?

🚀 Vollständige API-Abdeckung

  • 12 MCP-Tools, die 100 % der Creatify-API-Funktionalität abdecken
  • 6 MCP-Ressourcen für umfassenden Datenzugriff
  • 5 Workflow-Eingabeaufforderungen für gängige Szenarien zur Videoerstellung
  • Protokollierung auf Unternehmensniveau mit 8 Schweregraden

🤖 KI-First-Design

  • Selbstdokumentation mit how_to_use Tool für KI-Assistenten
  • Intelligente Parametervalidierung und Fehlerbehandlung
  • Echtzeit-Fortschrittsaktualisierungen während der Videogenerierung
  • Semantische Versionierung mit automatisierten Releases

🎨 Erweiterte Funktionen

  • Emotions- und Gestensteuerung in erweiterter Lippensynchronisation
  • Benutzerdefinierte Avatar-Erstellung (DYOA – Design Your Own Avatar)
  • KI-gestützte Skriptgenerierung für jeden Videotyp
  • Optimierung von Kurzvideos für TikTok/Instagram/YouTube
  • Verwaltung und Integration von Hintergrundmusik

💼 Produktionsbereit

  • TypeScript für Typsicherheit und bessere IDE-Unterstützung
  • Umfassende Fehlerbehandlung mit detailliertem Kontext
  • Professionelles Logging für Monitoring und Debugging
  • Automatisiertes Testen und kontinuierliche Integration
  • Semantische Versionierung für zuverlässige Updates

📝 MCP-Eingabeaufforderungen (5 Workflow-Vorlagen)

  • create-product-demo - Professioneller Workflow für Produktdemonstrationen
  • create-social-content – Ansprechende Erstellung von Social-Media-Inhalten
  • create-educational-video - Workflow für Lehr- und Tutorialvideos
  • create-marketing-campaign – Erstellung von Videos für Marketingkampagnen
  • analyze-video-performance - Videoleistungsanalyse und -optimierung

Voraussetzungen

  • Node.js 18 oder höher
  • Creatify API-Anmeldeinformationen (Pro-Plan oder höher)

Installation

Von npm (empfohlen)

npm install -g @tsavo/creatify-mcp

Aus der Quelle

git clone https://github.com/TSavo/creatify-mcp.git cd creatify-mcp npm install npm run build npm link

🎬 Live-Demo-Beispiele

Erstellen Sie ein KI-Avatar-Video

User: "Create a professional avatar video with Anna saying 'Welcome to our company!' in 16:9 format" Claude: I'll create a professional avatar video for you using the Creatify MCP Server. [Uses create_avatar_video tool with: - text: "Welcome to our company!" - avatarId: "anna_costume1_cameraA" - aspectRatio: "16:9" - voiceId: "en-US-AriaNeural"] Your professional avatar video has been created! Anna delivers your message with natural lip-sync and professional presentation.

Erstellen Sie ein kurzes Video im TikTok-Stil

User: "Make a 30-second TikTok video about coffee brewing tips" Claude: I'll create an engaging short-form video perfect for TikTok! [Uses create_ai_shorts tool with: - prompt: "Quick coffee brewing tips with energetic presentation" - aspectRatio: "9:16" - duration: 30 - style: "energetic"] Your TikTok-ready short video is being generated with optimal 9:16 aspect ratio and engaging content!

Website in Video konvertieren

User: "Turn my product landing page into a marketing video" Claude: I'll convert your website into a compelling marketing video. [Uses create_url_to_video tool with: - url: "https://yourproduct.com" - aspectRatio: "16:9" - style: "marketing"] Your landing page has been transformed into a professional marketing video showcasing your product!

KI-gestützte Skriptgenerierung

User: "Generate a script for a 60-second product demo video" Claude: I'll create a compelling script for your product demo. [Uses generate_ai_script tool with: - topic: "Product demonstration video" - scriptType: "commercial" - duration: 60 - tone: "professional"] Your script is ready! It includes engaging hooks, clear value propositions, and a strong call-to-action optimized for 60-second format.

Konfiguration

Legen Sie Ihre Creatify-API-Anmeldeinformationen als Umgebungsvariablen fest:

export CREATIFY_API_ID="your-api-id" export CREATIFY_API_KEY="your-api-key"

Oder erstellen Sie eine .env Datei:

CREATIFY_API_ID=your-api-id CREATIFY_API_KEY=your-api-key

Verwendung

Mit Claude Desktop

Fügen Sie Ihrer Claude Desktop-Konfiguration hinzu ( ~/Library/Application Support/Claude/claude_desktop_config.json unter macOS):

{ "mcpServers": { "creatify": { "command": "creatify-mcp", "env": { "CREATIFY_API_ID": "your-api-id", "CREATIFY_API_KEY": "your-api-key" } } } }

🎨 Erweiterte MCP-Funktionen

📝 Verwenden von Eingabeaufforderungen (Workflow-Vorlagen)

KI-Assistenten können jetzt vordefinierte Workflow-Vorlagen für gängige Szenarien zur Videoerstellung verwenden:

Beispiel: Produktdemo-Workflow

User: "Use the create-product-demo prompt for 'Amazing Widget' with features 'fast, reliable, easy to use' targeting small business owners" Claude: I'll use the product demo workflow template to create a professional demonstration video. [Claude automatically follows the complete workflow: 1. Generates an engaging script using generate_ai_script 2. Creates avatar video using create_avatar_video 3. Optimizes for the target audience 4. Includes clear call-to-action]

Verfügbare Eingabeaufforderungsvorlagen:

  • create-product-demo - Professionelle Produktdemonstrationen
  • create-social-content – TikTok-/Instagram-/YouTube-Inhalte
  • create-educational-video - Tutorials und Bildungsinhalte
  • create-marketing-campaign - Marketing- und Werbevideos
  • analyze-video-performance - Videooptimierung und -analyse
📊 Echtzeit-Protokollierung und Fortschritt

Der Server bietet eine strukturierte Protokollierung mit mehreren Schweregraden:

[INFO] Creatify MCP Server initialized [INFO] Creating avatar video {avatarId: "anna_costume1_cameraA", aspectRatio: "16:9"} [INFO] Waiting for avatar video completion... [INFO] Avatar video completed {videoId: "video_abc123"}

Protokollebenen: debug , info , notice , warning , error , critical , alert , emergency

🤖 KI-Selbsthilfesystem

KI-Assistenten können Werkzeugparameter jetzt mithilfe des Tools how_to_use besser verstehen:

Claude: Let me check how to use the avatar video tool... [Calls how_to_use tool with toolName: "create_avatar_video"] [Gets comprehensive documentation with: - Required parameters with descriptions - Optional parameters with usage notes - Real code examples - Tips and best practices] Now I understand exactly how to create your avatar video!

Mit benutzerdefiniertem MCP-Client

import { Client } from "@modelcontextprotocol/sdk/client/index.js"; import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js"; const transport = new StdioClientTransport({ command: "creatify-mcp", env: { CREATIFY_API_ID: "your-api-id", CREATIFY_API_KEY: "your-api-key" } }); const client = new Client({ name: "my-client", version: "1.0.0" }); await client.connect(transport); // List available tools const tools = await client.listTools(); console.log("Available tools:", tools.tools.map(t => t.name)); // Create an avatar video const result = await client.callTool({ name: "create_avatar_video", arguments: { text: "Hello, world! This is an AI-generated video.", avatarId: "anna_costume1_cameraA", aspectRatio: "16:9", waitForCompletion: true } });

Standalone-Server

# Set environment variables export CREATIFY_API_ID="your-api-id" export CREATIFY_API_KEY="your-api-key" # Run the server creatify-mcp

Beispiel-Eingabeaufforderungen für KI-Assistenten

Nach der Konfiguration mit Claude Desktop oder einem anderen MCP-Client können Sie Eingabeaufforderungen in natürlicher Sprache verwenden, wie:

  • „Erstellen Sie ein 16:9-Avatar-Video von Anna, in dem sie „Willkommen zu unserer Produktdemo“ sagt, und warten Sie, bis es abgeschlossen ist.“
  • „Konvertieren Sie die Website https://example.com in ein Werbevideo“
  • „Erstellen Sie Text-to-Speech-Audio für ‚Hallo Welt‘ mit einer professionellen Stimme.“
  • „Zeige mir alle verfügbaren Avatare und ihre Details“
  • „Meine verbleibenden Creatify-Guthaben prüfen“
  • „Erstellen Sie eine Unterhaltung zwischen zwei Avataren, die über unser neues Produkt diskutieren.“

API-Referenz

Werkzeuge

create_avatar_video

Erstellen Sie ein KI-Avatar-Video mit lippensynchroner Sprache.

Parameter:

  • text (Zeichenfolge, erforderlich) – Zu sprechender Text
  • avatarId (Zeichenfolge, erforderlich) – zu verwendende Avatar-ID
  • aspectRatio ("16:9" | "9:16" | "1:1", erforderlich) – Video-Seitenverhältnis
  • voiceId (Zeichenfolge, optional) – Sprach-ID für den Avatar
  • waitForCompletion (boolesch, optional) – Warten Sie, bis das Video fertig ist
create_url_to_video

Wandeln Sie eine Website-URL in ein professionelles Video um.

Parameter:

  • url (Zeichenfolge, erforderlich) – zu konvertierende URL
  • visualStyle (Zeichenfolge, optional) – Visuelle Stilvorlage
  • scriptStyle (Zeichenfolge, optional) – Skriptschreibstil
  • aspectRatio ("16:9" | "9:16" | "1:1", optional) – Video-Seitenverhältnis
  • waitForCompletion (boolesch, optional) – Warten Sie, bis das Video fertig ist
generate_text_to_speech

Generieren Sie aus Text natürlich klingende Sprache.

Parameter:

  • text (Zeichenfolge, erforderlich) – In Sprache umzuwandelnder Text
  • voiceId (Zeichenfolge, erforderlich) – zu verwendende Sprach-ID
  • waitForCompletion (boolesch, optional) – Warten auf Audioabschluss
get_video_status

Überprüfen Sie den Status einer Videogenerierungsaufgabe.

Parameter:

  • videoId (Zeichenfolge, erforderlich) – Zu prüfende Video-/Aufgaben-ID
  • videoType (Zeichenfolge, erforderlich) – Aufgabentyp („Lippensynchronisation“, „URL-zu-Video“ usw.)

Ressourcen

creatify://avatars

Gibt eine JSON-Liste aller verfügbaren KI-Avatare mit ihren IDs, Namen und Metadaten zurück.

creatify://voices

Gibt eine JSON-Liste aller verfügbaren Stimmen für die Text-to-Speech-Generierung zurück.

creatify://templates

Gibt eine JSON-Liste der verfügbaren benutzerdefinierten Videovorlagen zurück.

creatify://credits

Gibt den aktuellen Kontostand und Nutzungsinformationen zurück.

Entwicklung

# Install dependencies npm install # Build the project npm run build # Run in development mode with auto-reload npm run dev # Run tests npm test # Lint and format code npm run check

Beitragen

  1. Forken Sie das Repository
  2. Erstellen Sie einen Feature-Zweig ( git checkout -b feature/amazing-feature )
  3. Übernehmen Sie Ihre Änderungen ( git commit -m 'Add amazing feature' )
  4. Pushen zum Zweig ( git push origin feature/amazing-feature )
  5. Öffnen einer Pull-Anfrage

Lizenz

MIT-Lizenz – Einzelheiten finden Sie in der Datei LICENSE .

Ähnliche Projekte

📚 Umfassende Dokumentation

🎬 Video-Tutorials

In Kürze verfügbar: umfassende Video-Tutorials mit praktischen Anwendungsszenarien

📖 API-Referenz

Eine ausführliche API-Dokumentation finden Sie unter:

🔧 Erweiterte Konfiguration

Umgebungsvariablen
VariableErforderlichBeschreibungBeispiel
CREATIFY_API_IDIhre Creatify API-IDyour-api-id-here
CREATIFY_API_KEYIhr Creatify API-Schlüsselyour-api-key-here
MCP_LOG_LEVELProtokollierungsebenedebug , info , warn , error
Erweiterte Konfiguration von Claude Desktop
{ "mcpServers": { "creatify": { "command": "creatify-mcp", "env": { "CREATIFY_API_ID": "your-api-id", "CREATIFY_API_KEY": "your-api-key", "MCP_LOG_LEVEL": "info" }, "args": ["--verbose"] } } }

🚀 Leistungsoptimierung

Batch-Operationen

Wenn Sie mehrere Videos erstellen möchten, sollten Sie die Stapelverarbeitungsfunktionen nutzen:

// Example: Create multiple videos efficiently const videos = await Promise.all([ client.callTool({ name: "create_avatar_video", arguments: { text: "Video 1", avatarId: "anna", aspectRatio: "16:9" } }), client.callTool({ name: "create_avatar_video", arguments: { text: "Video 2", avatarId: "john", aspectRatio: "16:9" } }) ]);
Caching-Strategien
  • Avatar-/Stimmenlisten : Cache für 1 Stunde (ändern sich selten)
  • Videostatus : Alle 5–10 Sekunden nach aktiven Aufgaben fragen
  • Vorlagen : Cache für 24 Stunden

🔐 Best Practices für die Sicherheit

  1. Übergeben Sie API-Schlüssel niemals der Versionskontrolle
  2. Verwenden Sie Umgebungsvariablen für alle sensiblen Daten
  3. Wechseln Sie regelmäßig die API-Schlüssel
  4. Überwachen Sie die API-Nutzung , um unbefugten Zugriff zu erkennen
  5. Verwenden Sie HTTPS für alle Webhook-URLs

🐛 Fehlerbehebung

Häufige Probleme

„API-Anmeldeinformationen nicht gefunden“

# Solution: Set environment variables export CREATIFY_API_ID="your-api-id" export CREATIFY_API_KEY="your-api-key"

„Videoerstellung fehlgeschlagen“

  • Überprüfen Sie Ihr Creatify-Kontoguthaben
  • Überprüfen Sie, ob Avatar-/Stimmen-IDs vorhanden sind
  • Stellen Sie sicher, dass der Text nicht leer ist
  • Überprüfen Sie, ob das Seitenverhältnis gültig ist

„MCP-Verbindung fehlgeschlagen“

  • Überprüfen Sie, ob der Server ausgeführt wird
  • Überprüfen Sie die Claude Desktop-Konfiguration
  • Stellen Sie sicher, dass die Node.js-Version >= 18 ist
Debug-Modus
# Run with debug logging MCP_LOG_LEVEL=debug creatify-mcp

📊 Überwachung und Analyse

Nutzungsverfolgung

Überwachen Sie Ihre Creatify-API-Nutzung:

// Check remaining credits const credits = await client.readResource({ uri: "creatify://credits" }); console.log(`Remaining credits: ${JSON.parse(credits.contents[0].text).remaining_credits}`);
Leistungsmetriken
  • Zeit für die Videoerstellung : Normalerweise 2–5 Minuten
  • API-Antwortzeit : Normalerweise < 2 Sekunden
  • Erfolgsrate : Überwachen Sie fehlgeschlagene Anfragen

🤝 Beitragen

Wir freuen uns über Ihre Beiträge! So können Sie loslegen:

🛠️ Entwicklungs-Setup

# Clone the repository git clone https://github.com/TSavo/creatify-mcp.git cd creatify-mcp # Install dependencies npm install # Set up environment variables cp .env.example .env # Edit .env with your API credentials # Run tests npm test # Build the project npm run build # Run in development mode npm run dev

🧪 Testen

# Run all tests npm test # Run tests in watch mode npm run test:watch # Run type checking npm run type-check # Run linting npm run lint

📝 Code-Stil

Wir verwenden:

  • ESLint für Code-Linting
  • Prettier für die Codeformatierung
  • TypeScript für Typsicherheit
  • Konventionelle Commits für Commit-Nachrichten

🔄 Pull Request-Prozess

  1. Forken Sie das Repository
  2. Erstellen Sie einen Feature-Zweig ( git checkout -b feature/amazing-feature )
  3. Nehmen Sie Ihre Änderungen vor
  4. Fügen Sie Tests für neue Funktionen hinzu
  5. Stellen Sie sicher, dass alle Tests erfolgreich sind ( npm test )
  6. Führen Sie eine Lint-Prüfung durch ( npm run lint:fix )
  7. Übernehmen Sie Ihre Änderungen ( git commit -m 'feat: add amazing feature' )
  8. Pushen zum Zweig ( git push origin feature/amazing-feature )
  9. Öffnen einer Pull-Anfrage

📄 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .

🙏 Danksagungen

  • Creatify AI – Für die Bereitstellung der erstaunlichen KI-Videogenerierungsplattform
  • @tsavo/creatify-api-ts – Die robuste TypeScript-Clientbibliothek, die diesen Server betreibt
  • Anthropisch - Für Claude und das Modellkontextprotokoll
  • MCP Community - Für das standardisierte Protokoll, das diese Integration ermöglicht

📞 Unterstützung


Erstellt mit ❤️ von T Savo

🌐 Horizon CityDie KI-Revolution einläuten und das Aussterben der Menschheit beschleunigen

KI-Videogenerierung für jeden Entwickler und KI-Assistenten zugänglich machen – der menschlichen Überflüssigmachung einen Schritt näher

Related MCP Servers

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/TSavo/creatify-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server