🎬 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-Selbsthilfe – how_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

• Creatify AI API – Die weltweit führende KI-Videogenerierungsplattform

• @tsavo/creatify-api-ts – Umfassende TypeScript-Clientbibliothek

• Model Context Protocol – Standardisierte KI-Assistenten-Integration

• TypeScript – Vollständige Typsicherheit und hervorragende Entwicklererfahrung

Related MCP server: Grok Imagine Video MCP Server

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)

  • Holen Sie sich Ihre API-Anmeldeinformationen aus den Creatify-Kontoeinstellungen

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

• @tsavo/creatify-api-ts – TypeScript-Client für die Creatify-API

• Model Context Protocol - Protokollspezifikation

• Creatify AI – KI-Plattform zur Videogenerierung

📚 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:

• Creatify API-Dokumentation – Offizielle Creatify API-Dokumente

• @tsavo/creatify-api-ts Dokumentation – TypeScript-Clientbibliothek-Dokumente

• Model Context Protocol Specification – MCP-Protokolldetails

🔧 Erweiterte Konfiguration

Umgebungsvariablen

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

• 📖 Creatify API-Dokumentation – Offizielle API-Dokumente

• 🐛 Probleme melden – Fehlerberichte und Funktionsanfragen

• 💬 MCP-Community – Community-Diskussionen

• 📧 Autor kontaktieren - Direkte Unterstützung

Erstellt mit ❤️ von T Savo

🌐 Horizon City – Die 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