Skip to main content
Glama

creatify-mcp

by TSavo

Servidor MCP de Creatify

El servidor MCP definitivo para la generación de videos con IA : lleva las poderosas capacidades de creación de videos de Creatify AI a todos los asistentes de IA en el ecosistema MCP.

🌟 Descripción general

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

🎨 Funciones avanzadas de MCP:

  • 📝 Prompts : plantillas y flujos de trabajo reutilizables para la creación de vídeos
  • 📊 Registro : registro estructurado con múltiples niveles de gravedad
  • 🔍Seguimiento del progreso : actualizaciones en tiempo real durante la generación del video
  • 🤖 AI Self-Help : herramienta how_to_use para que los asistentes de IA comprendan los parámetros
  • 📊 Notificaciones : actualizaciones de estado en tiempo real y notificaciones de progreso

🎯 Qué permite esto

Imagina decirle a Claude Desktop: "Crea un avatar de Anna en formato 16:9 diciendo 'Bienvenido a la demo de nuestro producto' y espera a que se complete" , y que realmente suceda. Ese es el poder de este servidor MCP.

🏗️ Construido con

Características

🛠️ Herramientas MCP (12 acciones poderosas)

  • create_avatar_video - Crea videos de avatar de IA con sincronización de labios
  • create_url_to_video - Convierte sitios web en vídeos profesionales
  • generate_text_to_speech - Genera un discurso con sonido natural a partir de texto
  • create_multi_avatar_conversation - Crea vídeos con múltiples avatares conversando
  • create_custom_template_video - Genera vídeos usando plantillas personalizadas
  • create_ai_edited_video - Edita y mejora vídeos automáticamente
  • create_ai_shorts : crea vídeos cortos (perfectos para TikTok e Instagram Reels)
  • generate_ai_script - Genera guiones con tecnología de IA para vídeos
  • create_custom_avatar - Diseña y crea tus propios avatares personalizados (DYOA)
  • manage_music - Sube, administra y usa música de fondo
  • create_advanced_lipsync - Sincronización de labios avanzada con control de emociones y gestos
  • how_to_use - Obtenga información detallada sobre el uso de cualquier herramienta
  • get_video_status - Verifica el estado de las tareas de generación de video

Recursos del 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 vídeo personalizadas disponibles
  • creatify://music - Biblioteca de música de fondo disponible
  • creatify://credits - Créditos API restantes
  • creatify://avatar/{avatarId} - Información detallada sobre avatares específicos

🏆 ¿Por qué elegir Creatify MCP Server?

🚀 Cobertura completa de API

  • 12 herramientas MCP que cubren el 100% de la funcionalidad de la API de Creatify
  • 6 recursos de MCP para un acceso integral a los datos
  • 5 indicaciones de flujo de trabajo para escenarios comunes de creación de videos
  • Registro de nivel empresarial con 8 niveles de gravedad

🤖 Diseño que prioriza la IA

  • Autodocumentación con 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 videos
  • Versiones semánticas con lanzamientos automatizados

🎨 Funciones avanzadas

  • Control de emociones y gestos en sincronización labial avanzada
  • Creación de avatar personalizado (DYOA - Diseña tu propio avatar)
  • Generación de guiones impulsada por IA para cualquier tipo de video
  • Optimización de vídeos 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 compatibilidad con IDE
  • Manejo integral de errores con contexto detallado
  • Registro profesional para monitoreo y depuración
  • Pruebas automatizadas e integración continua
  • Versiones semánticas para actualizaciones confiables

📝 Indicaciones de MCP (5 plantillas de flujo de trabajo)

  • create-product-demo - Flujo de trabajo de demostración de productos profesionales
  • create-social-content - Creación de contenido atractivo para redes sociales
  • create-educational-video - Flujo de trabajo de videos educativos y tutoriales
  • create-marketing-campaign - Creación de vídeos para campañas de marketing
  • analyze-video-performance - Análisis y optimización del rendimiento del video

Prerrequisitos

Instalación

De npm (recomendado)

npm install -g @tsavo/creatify-mcp

De la fuente

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

Ejemplos de demostraciones en vivo

Crear un video de avatar de 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 al 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 sitio web a vídeo

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 scripts 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

Establezca sus credenciales de 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

Agregue a su 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" } } } }

🎨 Funciones avanzadas de MCP

📝 Uso de indicaciones (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 videos:

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 indicaciones disponibles:

  • create-product-demo - Demostraciones profesionales de productos
  • create-social-content - Contenido de TikTok/Instagram/YouTube
  • create-educational-video - Tutoriales y contenido educativo
  • create-marketing-campaign - Vídeos de marketing y promoción
  • analyze-video-performance - Optimización y análisis de video
📊 Registro y progreso en tiempo real

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

[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 mediante 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 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 indicaciones para asistentes de IA

Una vez configurado con Claude Desktop u otro cliente MCP, puede utilizar indicaciones en lenguaje natural como:

  • Crea un avatar de Anna con una resolución de 16:9 que diga "Bienvenido a la demostración de nuestro producto" y espera a que se complete.
  • Convertir el sitio web https://example.com en un vídeo promocional
  • Genera audio de texto a voz para "Hola mundo" con una voz profesional.
  • "Muéstrame todos los avatares disponibles y sus detalles"
  • Consultar mis créditos restantes de Creatify
  • Crea una conversación entre dos avatares que discutan nuestro nuevo producto.

Referencia de API

Herramientas

create_avatar_video

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

Parámetros:

  • text (cadena, obligatorio) - Texto que se pronunciará
  • avatarId (cadena, obligatoria): ID de avatar a utilizar
  • aspectRatio ("16:9" | "9:16" | "1:1", obligatorio) - Relación de aspecto del vídeo
  • voiceId (cadena, opcional): ID de voz para el avatar
  • waitForCompletion (booleano, opcional): espera a que se complete el video
create_url_to_video

Convierte la URL de un sitio web en un vídeo profesional.

Parámetros:

  • url (cadena, obligatoria) - URL para convertir
  • visualStyle (cadena, opcional): plantilla de estilo visual
  • scriptStyle (cadena, opcional): estilo de escritura de scripts
  • aspectRatio ("16:9" | "9:16" | "1:1", opcional): relación de aspecto del vídeo
  • waitForCompletion (booleano, opcional): espera a que se complete el video
generate_text_to_speech

Genere un habla que suene natural a partir del texto.

Parámetros:

  • text (cadena, obligatorio) - Texto para convertir a voz
  • voiceId (cadena, obligatoria): ID de voz a utilizar
  • waitForCompletion (booleano, opcional): espera a que se complete el audio
get_video_status

Comprobar el estado de una tarea de generación de vídeo.

Parámetros:

  • videoId (cadena, obligatoria): ID de video/tarea a verificar
  • videoType (cadena, obligatoria) - Tipo de tarea ("sincronización de labios", "url al video", etc.)

Recursos

creatify://avatars

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

creatify://voices

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

creatify://templates

Devuelve una lista JSON de plantillas de vídeo personalizadas disponibles.

creatify://credits

Devuelve el saldo de crédito de la cuenta actual y la 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

Contribuyendo

  1. Bifurcar el repositorio
  2. Crear una rama de características ( git checkout -b feature/amazing-feature )
  3. Confirme sus cambios ( git commit -m 'Add amazing feature' )
  4. Empujar a la rama ( git push origin feature/amazing-feature )
  5. Abrir una solicitud de extracción

Licencia

Licencia MIT: consulte el archivo LICENCIA para obtener más detalles.

Proyectos relacionados

📚 Documentación completa

🎬 Tutoriales en vídeo

Próximamente: tutoriales en vídeo completos que muestran escenarios de uso del mundo real.

Referencia de API

Para obtener documentación detallada de la API, consulte:

🔧 Configuración avanzada

Variables de entorno
VariableRequeridoDescripciónEjemplo
CREATIFY_API_IDSu ID de API de Creatifyyour-api-id-here
CREATIFY_API_KEYSu clave API de Creatifyyour-api-key-here
MCP_LOG_LEVELNivel de registrodebug , 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 crear múltiples videos, considere 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 almacenamiento en caché
  • Listas de avatares/voces : se almacenan en caché durante 1 hora (rara vez cambian)
  • Estado del video : sondeo cada 5 a 10 segundos para tareas activas
  • Plantillas : Caché durante 24 horas

🔐 Mejores prácticas de seguridad

  1. Nunca envíe claves API al control de versiones
  2. Utilice variables de entorno para todos los datos confidenciales
  3. Rotar las claves API periódicamente
  4. Supervisar el uso de la API para detectar accesos no autorizados
  5. Utilice HTTPS para todas las URL de webhook

🐛 Solución de problemas

Problemas comunes

"No se encontraron credenciales de API"

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

"Error al crear el vídeo"

  • Consulta los créditos de tu cuenta Creatify
  • Verificar que existan identificaciones de avatar/voz
  • Asegúrese de que el texto no esté vacío
  • Compruebe que la relación de aspecto sea válida

"Error de conexión MCP"

  • Verifique que el servidor esté ejecutándose
  • Comprobar la configuración de Claude Desktop
  • Asegúrese 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

Supervise el 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 del video : generalmente de 2 a 5 minutos
  • Tiempo de respuesta de la API : generalmente < 2 segundos
  • Tasa de éxito : supervisar solicitudes fallidas

🤝 Contribuyendo

¡Agradecemos tus contribuciones! Aquí te explicamos cómo empezar:

Configuración del 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

Nosotros utilizamos:

  • ESLint para el análisis de código
  • Más bonito para el formato de código
  • TypeScript para seguridad de tipos
  • Confirmaciones convencionales para mensajes de confirmación

🔄 Proceso de solicitud de extracción

  1. Bifurcar el repositorio
  2. Crear una rama de características ( git checkout -b feature/amazing-feature )
  3. Realiza tus cambios
  4. Agregar pruebas para nuevas funcionalidades
  5. Asegúrese de que todas las pruebas pasen ( npm test )
  6. Ejecutar linting ( npm run lint:fix )
  7. Confirme sus cambios ( git commit -m 'feat: add amazing feature' )
  8. Empujar a la rama ( git push origin feature/amazing-feature )
  9. Abrir una solicitud de extracción

📄 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

🙏 Agradecimientos

  • Creatify AI : por proporcionar la increíble plataforma de generación de videos con IA
  • @tsavo/creatify-api-ts : la robusta biblioteca de cliente TypeScript que impulsa este servidor
  • Antrópico - Para Claude y el Protocolo de Contexto Modelo
  • Comunidad MCP : por el protocolo estandarizado que hace posible esta integración

📞 Soporte


Creado con ❤️ por T Savo

🌐 Horizon City : Marcando el comienzo de la revolución de la IA y acelerando la extinción de los humanos

Hacer que la generación de videos con IA sea accesible para todos los desarrolladores y asistentes de IA: un paso más cerca de la obsolescencia humana

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