🎬 MCP-Server erstellen

Name: creatify-mcp
Author: TSavo

npm-Version npm-Downloads Typoskript Node.js MCP Createify KI Lizenz: MIT GitHub-Stars GitHub-Probleme Semantische Freigabe

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: Clockify MCP

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

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

Lizenz

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

📚 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

Variable	Erforderlich	Beschreibung	Beispiel
`CREATIFY_API_ID`	✅	Ihre Creatify API-ID	`your-api-id-here`
`CREATIFY_API_KEY`	✅	Ihr Creatify API-Schlüssel	`your-api-key-here`
`MCP_LOG_LEVEL`	❌	Protokollierungsebene	`debug` , `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

Übergeben Sie API-Schlüssel niemals der Versionskontrolle
Verwenden Sie Umgebungsvariablen für alle sensiblen Daten
Wechseln Sie regelmäßig die API-Schlüssel
Überwachen Sie die API-Nutzung , um unbefugten Zugriff zu erkennen
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

Forken Sie das Repository
Erstellen Sie einen Feature-Zweig ( git checkout -b feature/amazing-feature )
Nehmen Sie Ihre Änderungen vor
Fügen Sie Tests für neue Funktionen hinzu
Stellen Sie sicher, dass alle Tests erfolgreich sind ( npm test )
Führen Sie eine Lint-Prüfung durch ( npm run lint:fix )
Übernehmen Sie Ihre Änderungen ( git commit -m 'feat: add amazing feature' )
Pushen zum Zweig ( git push origin feature/amazing-feature )
Ö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

🎬 MCP-Server erstellen

🌟 Übersicht

🎨 Erweiterte MCP-Funktionen:

🎯 Was dies ermöglicht

🏗️ Erstellt mit

Merkmale

🛠️ MCP-Tools (12 leistungsstarke Aktionen)

📚 MCP-Ressourcen (6 Datenquellen)

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

🚀 Vollständige API-Abdeckung

🤖 KI-First-Design

🎨 Erweiterte Funktionen

💼 Produktionsbereit

📝 MCP-Eingabeaufforderungen (5 Workflow-Vorlagen)

Voraussetzungen

Installation

Von npm (empfohlen)

Aus der Quelle

🎬 Live-Demo-Beispiele

Erstellen Sie ein KI-Avatar-Video

Erstellen Sie ein kurzes Video im TikTok-Stil

Website in Video konvertieren

KI-gestützte Skriptgenerierung

Konfiguration

Verwendung

Mit Claude Desktop

🎨 Erweiterte MCP-Funktionen

📝 Verwenden von Eingabeaufforderungen (Workflow-Vorlagen)

📊 Echtzeit-Protokollierung und Fortschritt

🤖 KI-Selbsthilfesystem

Mit benutzerdefiniertem MCP-Client

Standalone-Server

Beispiel-Eingabeaufforderungen für KI-Assistenten

API-Referenz

Werkzeuge

create_avatar_video

create_url_to_video

generate_text_to_speech

get_video_status

Ressourcen

creatify://avatars

creatify://voices

creatify://templates

creatify://credits

Entwicklung

Beitragen

Lizenz

Ähnliche Projekte

📚 Umfassende Dokumentation

🎬 Video-Tutorials

📖 API-Referenz

🔧 Erweiterte Konfiguration

Umgebungsvariablen

Erweiterte Konfiguration von Claude Desktop

🚀 Leistungsoptimierung

Batch-Operationen

Caching-Strategien

🔐 Best Practices für die Sicherheit

🐛 Fehlerbehebung

Häufige Probleme

Debug-Modus

📊 Überwachung und Analyse

Nutzungsverfolgung

Leistungsmetriken

🤝 Beitragen

🛠️ Entwicklungs-Setup

🧪 Testen

📝 Code-Stil

🔄 Pull Request-Prozess

📄 Lizenz

🙏 Danksagungen

📞 Unterstützung

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API

`create_avatar_video`

`create_url_to_video`

`generate_text_to_speech`

`get_video_status`

`creatify://avatars`

`creatify://voices`

`creatify://templates`

`creatify://credits`