Creatify

Servidor MCP que expone las capacidades de la API de Creatify AI para la generación de videos con IA, incluyendo videos con avatares, conversión de URL a video, texto a voz y herramientas de edición impulsadas por IA.

GitHub

Prueba este MCPPatrocinado

Documentación

🎬 Servidor MCP de Creatify

El servidor MCP definitivo para generación de video con IA - Llevando las potentes capacidades de creación de video de Creatify AI a cada asistente de IA en el ecosistema MCP.

🌟 Descripción general

El Servidor MCP de Creatify es un servidor integral del Protocolo de Contexto de Modelo (MCP) que expone todo el poder de la plataforma de generación de video de Creatify AI a asistentes de IA, chatbots y herramientas de automatización. Construido sobre la robusta biblioteca cliente TypeScript @tsavo/creatify-api-ts, este servidor transforma flujos de trabajo complejos de creación de video en interacciones simples en lenguaje natural.

🎨 Características avanzadas de MCP:

📝 Prompts - Plantillas y flujos de trabajo reutilizables para creación de video
📊 Registro (Logging) - Registro estructurado con múltiples niveles de severidad
🔍 Seguimiento de progreso - Actualizaciones en tiempo real durante la generación de video
🤖 Autoayuda con IA - Herramienta how_to_use para que los asistentes de IA comprendan los parámetros
📊 Notificaciones - Actualizaciones de estado y notificaciones de progreso en tiempo real

🎯 Lo que esto permite

Imagina decirle a Claude Desktop: "Crea un video de avatar 16:9 de Anna diciendo 'Bienvenido a nuestra demostración de producto' y espera a que se complete" - y que realmente suceda. Ese es el poder de este servidor MCP.

🏗️ Construido con

API de Creatify AI - La plataforma líder mundial en generación de video con IA
@tsavo/creatify-api-ts - Biblioteca cliente TypeScript integral
Protocolo de Contexto de Modelo - Integración estandarizada para asistentes de IA
TypeScript - Seguridad total de tipos y excelente experiencia de desarrollo

Características

🛠️ Herramientas MCP (12 acciones potentes)

create_avatar_video - Crea videos de avatar con IA y sincronización de labios
create_url_to_video - Convierte sitios web en videos profesionales
generate_text_to_speech - Genera voz natural a partir de texto
create_multi_avatar_conversation - Crea videos con múltiples avatares que mantienen conversaciones
create_custom_template_video - Genera videos usando plantillas personalizadas
create_ai_edited_video - Edita y mejora videos automáticamente
create_ai_shorts - Crea videos de formato corto (perfectos para TikTok, Instagram Reels)
generate_ai_script - Genera guiones impulsados por IA para videos
create_custom_avatar - Diseña y crea tus propios avatares personalizados (DYOA)
manage_music - Sube, gestiona y usa música de fondo
create_advanced_lipsync - Sincronización de labios avanzada con control de emociones y gestos
how_to_use - Obtén información detallada de uso para cualquier herramienta
get_video_status - Verifica el estado de las tareas de generación de video

📚 Recursos MCP (6 fuentes de datos)

creatify://avatars - Lista de avatares de IA disponibles
creatify://voices - Lista de voces disponibles para texto a voz
creatify://templates - Plantillas de video personalizadas disponibles
creatify://music - Biblioteca de música de fondo disponible
creatify://credits - Créditos de API restantes
creatify://avatar/{avatarId} - Información detallada sobre avatares específicos

🏆 ¿Por qué elegir el Servidor MCP de Creatify?

🚀 Cobertura completa de la API

✅ 12 herramientas MCP que cubren el 100% de la funcionalidad de la API de Creatify
✅ 6 recursos MCP para acceso integral a datos
✅ 5 prompts de flujo de trabajo para escenarios comunes de creación de video
✅ Registro de nivel empresarial con 8 niveles de severidad

🤖 Diseño centrado en IA

✅ Autodocumentado con la herramienta how_to_use para asistentes de IA
✅ Validación inteligente de parámetros y manejo de errores
✅ Actualizaciones de progreso en tiempo real durante la generación de video
✅ Versionado semántico con lanzamientos automatizados

🎨 Características avanzadas

✅ Control de emociones y gestos en sincronización de labios avanzada
✅ Creación de avatares personalizados (DYOA - Diseña tu propio avatar)
✅ Generación de guiones impulsada por IA para cualquier tipo de video
✅ Optimización de video de formato corto para TikTok/Instagram/YouTube
✅ Gestión e integración de música de fondo

💼 Listo para producción

✅ TypeScript para seguridad de tipos y mejor soporte de IDE
✅ Manejo integral de errores con contexto detallado
✅ Registro profesional para monitoreo y depuración
✅ Pruebas automatizadas e integración continua
✅ Versionado semántico para actualizaciones confiables

📝 Prompts MCP (5 plantillas de flujo de trabajo)

create-product-demo - Flujo de trabajo profesional de demostración de producto
create-social-content - Creación de contenido atractivo para redes sociales
create-educational-video - Flujo de trabajo de video educativo y tutorial
create-marketing-campaign - Creación de video para campañas de marketing
analyze-video-performance - Análisis y optimización del rendimiento de video

Requisitos previos

Node.js 18 o superior
Credenciales de la API de Creatify (plan Pro o superior)
- Obtén tus credenciales de API desde configuración de la cuenta de Creatify

Instalación

Desde npm (recomendado)

npm install -g @tsavo/creatify-mcp

Desde el código fuente

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

🎬 Ejemplos de demostración en vivo

Crear un video de avatar con IA

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.

Generar un video corto estilo TikTok

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!

Convertir un sitio web en video

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!

Generación de guiones impulsada por IA

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.

Configuración

Establece tus credenciales de la API de Creatify como variables de entorno:

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

O crea un archivo .env:

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

Uso

Con Claude Desktop

Agrega a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

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

🎨 Características avanzadas de MCP

📝 Uso de prompts (plantillas de flujo de trabajo)

Los asistentes de IA ahora pueden usar plantillas de flujo de trabajo predefinidas para escenarios comunes de creación de video:

Ejemplo: Flujo de trabajo de demostración de producto

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]

Plantillas de prompts disponibles:

create-product-demo - Demostraciones profesionales de productos
create-social-content - Contenido para TikTok/Instagram/YouTube
create-educational-video - Tutoriales y contenido educativo
create-marketing-campaign - Videos de marketing y promocionales
analyze-video-performance - Optimización y análisis de video

📊 Registro y progreso en tiempo real

El servidor proporciona registro estructurado con múltiples niveles de severidad:

[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"}

Niveles de registro: debug, info, notice, warning, error, critical, alert, emergency

🤖 Sistema de autoayuda con IA

Los asistentes de IA ahora pueden comprender mejor los parámetros de las herramientas usando la herramienta how_to_use:

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!

Con un cliente MCP personalizado

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
  }
});

Servidor independiente

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

# Run the server
creatify-mcp

Ejemplos de prompts para asistentes de IA

Una vez configurado con Claude Desktop u otro cliente MCP, puedes usar prompts en lenguaje natural como:

"Crea un video de avatar 16:9 de Anna diciendo 'Bienvenido a nuestra demostración de producto' y espera a que se complete"
"Convierte el sitio web https://example.com en un video promocional"
"Genera audio de texto a voz para 'Hola mundo' usando una voz profesional"
"Muéstrame todos los avatares disponibles y sus detalles"
"Verifica mis créditos restantes de Creatify"
"Crea una conversación entre dos avatares discutiendo nuestro nuevo producto"

Referencia de la API

Herramientas

`create_avatar_video`

Crea un video de avatar con IA y voz sincronizada con los labios.

Parámetros:

text (cadena, obligatorio) - Texto que se hablará
avatarId (cadena, obligatorio) - ID del avatar a usar
aspectRatio ("16:9" | "9:16" | "1:1", obligatorio) - Relación de aspecto del video
voiceId (cadena, opcional) - ID de voz para el avatar
waitForCompletion (booleano, opcional) - Esperar a que el video se complete

`create_url_to_video`

Convierte una URL de sitio web en un video profesional.

Parámetros:

url (cadena, obligatorio) - URL a convertir
visualStyle (cadena, opcional) - Plantilla de estilo visual
scriptStyle (cadena, opcional) - Estilo de escritura del guion
aspectRatio ("16:9" | "9:16" | "1:1", opcional) - Relación de aspecto del video
waitForCompletion (booleano, opcional) - Esperar a que el video se complete

`generate_text_to_speech`

Genera voz natural a partir de texto.

Parámetros:

text (cadena, obligatorio) - Texto a convertir en voz
voiceId (cadena, obligatorio) - ID de voz a usar
waitForCompletion (booleano, opcional) - Esperar a que el audio se complete

`get_video_status`

Verifica el estado de una tarea de generación de video.

Parámetros:

videoId (cadena, obligatorio) - ID del video/tarea a verificar
videoType (cadena, obligatorio) - Tipo de tarea ("lipsync", "url-to-video", etc.)

Recursos

`creatify://avatars`

Devuelve una lista JSON de todos los avatares de IA disponibles con sus IDs, nombres y metadatos.

`creatify://voices`

Devuelve una lista JSON de todas las voces disponibles para generación de texto a voz.

`creatify://templates`

Devuelve una lista JSON de plantillas de video personalizadas disponibles.

`creatify://credits`

Devuelve el saldo de créditos de la cuenta actual e información de uso.

Desarrollo

# 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

Contribuciones

Haz un fork del repositorio
Crea una rama de características (git checkout -b feature/amazing-feature)
Realiza tus cambios (git commit -m 'Add amazing feature')
Empuja a la rama (git push origin feature/amazing-feature)
Abre una solicitud de extracción (Pull Request)

Licencia

Licencia MIT - consulta el archivo LICENSE para más detalles.

Proyectos relacionados

@tsavo/creatify-api-ts - Cliente TypeScript para la API de Creatify
Protocolo de Contexto de Modelo - Especificación del protocolo
Creatify AI - Plataforma de generación de video con IA

📚 Documentación integral

🎬 Tutoriales en video

Próximamente - tutoriales en video integrales que muestran escenarios de uso en el mundo real

📖 Referencia de la API

Para documentación detallada de la API, consulta:

Documentación de la API de Creatify - Documentación oficial de la API de Creatify
Documentación de @tsavo/creatify-api-ts - Documentación de la biblioteca cliente TypeScript
Especificación del Protocolo de Contexto de Modelo - Detalles del protocolo MCP

🔧 Configuración avanzada

Variables de entorno

Variable	Obligatoria	Descripción	Ejemplo
`CREATIFY_API_ID`	✅	Tu ID de API de Creatify	`your-api-id-here`
`CREATIFY_API_KEY`	✅	Tu clave de API de Creatify	`your-api-key-here`
`MCP_LOG_LEVEL`	❌	Nivel de registro	`debug`, `info`, `warn`, `error`

Configuración avanzada de 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"]
    }
  }
}

🚀 Optimización del rendimiento

Operaciones por lotes

Para múltiples creaciones de video, considera usar las capacidades de procesamiento por lotes:

// 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" }
  })
]);

Estrategias de caché

Listas de avatares/voces: Almacenar en caché durante 1 hora (rara vez cambian)
Estado del video: Consultar cada 5-10 segundos para tareas activas
Plantillas: Almacenar en caché durante 24 horas

🔐 Mejores prácticas de seguridad

Nunca comprometas las claves de API en el control de versiones
Usa variables de entorno para todos los datos sensibles
Rota las claves de API regularmente
Monitorea el uso de la API para detectar accesos no autorizados
Usa HTTPS para todas las URLs de webhook

🐛 Solución de problemas

Problemas comunes

"Credenciales de API no encontradas"

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

"Falló la creación del video"

Verifica los créditos de tu cuenta de Creatify
Confirma que los IDs de avatar/voz existen
Asegúrate de que el texto no esté vacío
Verifica que la relación de aspecto sea válida

"Falló la conexión MCP"

Verifica que el servidor esté en ejecución
Revisa la configuración de Claude Desktop
Asegúrate de que la versión de Node.js sea >= 18

Modo de depuración

# Run with debug logging
MCP_LOG_LEVEL=debug creatify-mcp

📊 Monitoreo y análisis

Seguimiento de uso

Monitorea tu uso de la API de Creatify:

// Check remaining credits
const credits = await client.readResource({ uri: "creatify://credits" });
console.log(`Remaining credits: ${JSON.parse(credits.contents[0].text).remaining_credits}`);

Métricas de rendimiento

Tiempo de creación de video: Generalmente 2-5 minutos
Tiempo de respuesta de la API: Usualmente < 2 segundos
Tasa de éxito: Monitorea las solicitudes fallidas

🤝 Contribuciones

¡Damos la bienvenida a las contribuciones! Así es como empezar:

🛠️ Configuración de desarrollo

# 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

🧪 Pruebas

# 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

📝 Estilo de código

Usamos:

ESLint para el linting de código
Prettier para el formateo de código
TypeScript para la seguridad de tipos
Conventional Commits para los mensajes de commit

🔄 Proceso de solicitud de extracción

Hacer un fork del repositorio
Crear una rama de características (git checkout -b feature/amazing-feature)
Realiza tus cambios
Agrega pruebas para la nueva funcionalidad
Asegúrate de que todas las pruebas pasen (npm test)
Ejecuta el linting (npm run lint:fix)
Haz commit de tus cambios (git commit -m 'feat: add amazing feature')
Haz push a la rama (git push origin feature/amazing-feature)
Abre una solicitud de extracción

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.

🙏 Agradecimientos

Creatify AI - Por proporcionar la increíble plataforma de generación de video con IA
@tsavo/creatify-api-ts - La robusta biblioteca cliente de TypeScript que impulsa este servidor
Anthropic - Por Claude y el Model Context Protocol
Comunidad MCP - Por el protocolo estandarizado que hace posible esta integración

📞 Soporte

📖 Documentación de la API de Creatify - Documentación oficial de la API
🐛 Reportar problemas - Informes de errores y solicitudes de características
💬 Comunidad MCP - Discusiones de la comunidad
📧 Contactar al autor - Soporte directo

Creado con ❤️ por T Savo

🌐 Horizon City - Dando paso a la revolución de la IA y acelerando la extinción de los humanos

Haciendo que la generación de video con IA sea accesible para cada desarrollador y asistente de IA - un paso más cerca de la obsolescencia humana