Creatify

Servidor MCP que expõe as capacidades da API Creatify AI para geração de vídeos com IA, incluindo vídeos com avatares, conversão de URL em vídeo, texto para fala e ferramentas de edição com IA.

GitHub

Experimente este MCPPatrocinado

Documentação

🎬 Servidor MCP Creatify

O servidor MCP definitivo para geração de vídeos com IA - Trazendo os poderosos recursos de criação de vídeos do Creatify AI para todos os assistentes de IA no ecossistema MCP.

🌟 Visão Geral

O Servidor MCP Creatify é um servidor abrangente do Model Context Protocol (MCP) que expõe todo o poder da plataforma de geração de vídeos do Creatify AI para assistentes de IA, chatbots e ferramentas de automação. Construído sobre a robusta biblioteca cliente TypeScript @tsavo/creatify-api-ts, este servidor transforma fluxos de trabalho complexos de criação de vídeos em interações simples em linguagem natural.

🎨 Recursos MCP Avançados:

📝 Prompts - Modelos e fluxos de trabalho reutilizáveis para criação de vídeos
📊 Registro (Logging) - Registro estruturado com múltiplos níveis de severidade
🔍 Acompanhamento de Progresso - Atualizações em tempo real durante a geração de vídeos
🤖 Autoatendimento com IA - Ferramenta how_to_use para assistentes de IA entenderem parâmetros
📊 Notificações - Atualizações de status e notificações de progresso em tempo real

🎯 O Que Isso Permite

Imagine dizer ao Claude Desktop: "Crie um vídeo de avatar 16:9 da Anna dizendo 'Bem-vindo à nossa demonstração do produto' e aguarde a conclusão" - e isso realmente acontecer. Esse é o poder deste servidor MCP.

🏗️ Construído Com

API Creatify AI - A plataforma líder mundial em geração de vídeos com IA
@tsavo/creatify-api-ts - Biblioteca cliente TypeScript abrangente
Model Context Protocol - Integração padronizada para assistentes de IA
TypeScript - Segurança total de tipos e excelente experiência de desenvolvimento

Recursos

🛠️ Ferramentas MCP (12 ações poderosas)

create_avatar_video - Crie vídeos de avatar com IA e sincronização labial
create_url_to_video - Converta sites em vídeos profissionais
generate_text_to_speech - Gere fala com som natural a partir de texto
create_multi_avatar_conversation - Crie vídeos com múltiplos avatares em conversa
create_custom_template_video - Gere vídeos usando modelos personalizados
create_ai_edited_video - Edite e aprimore vídeos automaticamente
create_ai_shorts - Crie vídeos de formato curto (perfeitos para TikTok, Instagram Reels)
generate_ai_script - Gere roteiros com IA para vídeos
create_custom_avatar - Projete e crie seus próprios avatares personalizados (DYOA)
manage_music - Envie, gerencie e use músicas de fundo
create_advanced_lipsync - Sincronização labial avançada com controle de emoção e gestos
how_to_use - Obtenha informações detalhadas de uso para qualquer ferramenta
get_video_status - Verifique o status das tarefas de geração de vídeo

📚 Recursos MCP (6 fontes de dados)

creatify://avatars - Lista de avatares de IA disponíveis
creatify://voices - Lista de vozes disponíveis para texto-para-fala
creatify://templates - Modelos de vídeo personalizados disponíveis
creatify://music - Biblioteca de músicas de fundo disponíveis
creatify://credits - Créditos de API restantes
creatify://avatar/{avatarId} - Informações detalhadas sobre avatares específicos

🏆 Por Que Escolher o Servidor MCP Creatify?

🚀 Cobertura Completa da API

✅ 12 Ferramentas MCP cobrindo 100% da funcionalidade da API Creatify
✅ 6 Recursos MCP para acesso abrangente a dados
✅ 5 Prompts de Fluxo de Trabalho para cenários comuns de criação de vídeos
✅ Registro de nível empresarial com 8 níveis de severidade

🤖 Design Focado em IA

✅ Autodocumentável com a ferramenta how_to_use para assistentes de IA
✅ Validação inteligente de parâmetros e tratamento de erros
✅ Atualizações de progresso em tempo real durante a geração de vídeos
✅ Versionamento semântico com lançamentos automatizados

🎨 Recursos Avançados

✅ Controle de emoção e gestos na sincronização labial avançada
✅ Criação de avatares personalizados (DYOA - Design Your Own Avatar)
✅ Geração de roteiros com IA para qualquer tipo de vídeo
✅ Otimização de vídeos de formato curto para TikTok/Instagram/YouTube
✅ Gerenciamento e integração de músicas de fundo

💼 Pronto para Produção

✅ TypeScript para segurança de tipos e melhor suporte a IDE
✅ Tratamento abrangente de erros com contexto detalhado
✅ Registro profissional para monitoramento e depuração
✅ Testes automatizados e integração contínua
✅ Versionamento semântico para atualizações confiáveis

📝 Prompts MCP (5 modelos de fluxo de trabalho)

create-product-demo - Fluxo de trabalho profissional de demonstração de produtos
create-social-content - Criação de conteúdo envolvente para mídias sociais
create-educational-video - Fluxo de trabalho de vídeos educacionais e tutoriais
create-marketing-campaign - Criação de vídeos para campanhas de marketing
analyze-video-performance - Análise e otimização de desempenho de vídeos

Pré-requisitos

Node.js 18 ou superior
Credenciais da API Creatify (plano Pro ou superior)
- Obtenha suas credenciais de API nas configurações da conta Creatify

Instalação

Pelo npm (recomendado)

npm install -g @tsavo/creatify-mcp

Pelo código-fonte

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

🎬 Exemplos de Demonstração ao Vivo

Crie um Vídeo de Avatar com 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.

Gere um Vídeo Curto 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!

Converta um Site em 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!

Geração de Roteiro com 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.

Configuração

Defina suas credenciais da API Creatify como variáveis de ambiente:

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

Ou crie um arquivo .env:

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

Uso

Com o Claude Desktop

Adicione à configuração do seu Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json no macOS):

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

🎨 Recursos MCP Avançados

📝 Usando Prompts (Modelos de Fluxo de Trabalho)

Os assistentes de IA agora podem usar modelos de fluxo de trabalho predefinidos para cenários comuns de criação de vídeos:

Exemplo: Fluxo de Trabalho de Demonstração de Produto

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]

Modelos de Prompt Disponíveis:

create-product-demo - Demonstrações profissionais de produtos
create-social-content - Conteúdo para TikTok/Instagram/YouTube
create-educational-video - Tutoriais e conteúdo educacional
create-marketing-campaign - Vídeos de marketing e promocionais
analyze-video-performance - Otimização e análise de vídeos

📊 Registro e Progresso em Tempo Real

O servidor fornece registro estruturado com múltiplos níveis de severidade:

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

Níveis de Registro: debug, info, notice, warning, error, critical, alert, emergency

🤖 Sistema de Autoatendimento com IA

Os assistentes de IA agora podem entender melhor os parâmetros das ferramentas usando a ferramenta 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!

Com um 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 Autônomo

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

# Run the server
creatify-mcp

Exemplos de Prompts para Assistentes de IA

Depois de configurado com o Claude Desktop ou outro cliente MCP, você pode usar prompts em linguagem natural como:

"Crie um vídeo de avatar 16:9 da Anna dizendo 'Bem-vindo à nossa demonstração do produto' e aguarde a conclusão"
"Converta o site https://example.com em um vídeo promocional"
"Gere áudio de texto-para-fala para 'Olá mundo' usando uma voz profissional"
"Mostre-me todos os avatares disponíveis e seus detalhes"
"Verifique meus créditos restantes do Creatify"
"Crie uma conversa entre dois avatares discutindo nosso novo produto"

Referência da API

Ferramentas

`create_avatar_video`

Crie um vídeo de avatar com IA e fala sincronizada com os lábios.

Parâmetros:

text (string, obrigatório) - Texto a ser falado
avatarId (string, obrigatório) - ID do avatar a ser usado
aspectRatio ("16:9" | "9:16" | "1:1", obrigatório) - Proporção de aspecto do vídeo
voiceId (string, opcional) - ID da voz para o avatar
waitForCompletion (booleano, opcional) - Aguardar a conclusão do vídeo

`create_url_to_video`

Converta uma URL de site em um vídeo profissional.

Parâmetros:

url (string, obrigatório) - URL a ser convertida
visualStyle (string, opcional) - Modelo de estilo visual
scriptStyle (string, opcional) - Estilo de escrita do roteiro
aspectRatio ("16:9" | "9:16" | "1:1", opcional) - Proporção de aspecto do vídeo
waitForCompletion (booleano, opcional) - Aguardar a conclusão do vídeo

`generate_text_to_speech`

Gere fala com som natural a partir de texto.

Parâmetros:

text (string, obrigatório) - Texto a ser convertido em fala
voiceId (string, obrigatório) - ID da voz a ser usada
waitForCompletion (booleano, opcional) - Aguardar a conclusão do áudio

`get_video_status`

Verifique o status de uma tarefa de geração de vídeo.

Parâmetros:

videoId (string, obrigatório) - ID do vídeo/tarefa a ser verificado
videoType (string, obrigatório) - Tipo de tarefa ("lipsync", "url-to-video", etc.)

Recursos

`creatify://avatars`

Retorna uma lista JSON de todos os avatares de IA disponíveis com seus IDs, nomes e metadados.

`creatify://voices`

Retorna uma lista JSON de todas as vozes disponíveis para geração de texto-para-fala.

`creatify://templates`

Retorna uma lista JSON dos modelos de vídeo personalizados disponíveis.

`creatify://credits`

Retorna o saldo de créditos da conta e informações de uso atuais.

Desenvolvimento

# 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

Contribuindo

Faça um fork do repositório
Crie um branch de recurso (git checkout -b feature/amazing-feature)
Faça commit das suas alterações (git commit -m 'Add amazing feature')
Envie para o branch (git push origin feature/amazing-feature)
Abra um Pull Request

Licença

Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Projetos Relacionados

@tsavo/creatify-api-ts - Cliente TypeScript para a API Creatify
Model Context Protocol - Especificação do protocolo
Creatify AI - Plataforma de geração de vídeos com IA

📚 Documentação Abrangente

🎬 Tutoriais em Vídeo

Em breve - tutoriais em vídeo abrangentes mostrando cenários de uso no mundo real

📖 Referência da API

Para documentação detalhada da API, consulte:

Documentação da API Creatify - Documentação oficial da API Creatify
Documentação do @tsavo/creatify-api-ts - Documentação da biblioteca cliente TypeScript
Especificação do Model Context Protocol - Detalhes do protocolo MCP

🔧 Configuração Avançada

Variáveis de Ambiente

Variável	Obrigatória	Descrição	Exemplo
`CREATIFY_API_ID`	✅	Seu ID da API Creatify	`your-api-id-here`
`CREATIFY_API_KEY`	✅	Sua chave da API Creatify	`your-api-key-here`
`MCP_LOG_LEVEL`	❌	Nível de registro	`debug`, `info`, `warn`, `error`

Configuração Avançada do 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"]
    }
  }
}

🚀 Otimização de Desempenho

Operações em Lote

Para múltiplas criações de vídeos, considere usar os recursos de processamento em lote:

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

Estratégias de Cache

Listas de Avatares/Vozes: Cache por 1 hora (raramente mudam)
Status do Vídeo: Consulte a cada 5-10 segundos para tarefas ativas
Modelos: Cache por 24 horas

🔐 Melhores Práticas de Segurança

Nunca faça commit de chaves de API no controle de versão
Use variáveis de ambiente para todos os dados confidenciais
Rotacione as chaves de API regularmente
Monitore o uso da API para detectar acesso não autorizado
Use HTTPS para todas as URLs de webhook

🐛 Solução de Problemas

Problemas Comuns

"Credenciais da API não encontradas"

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

"Falha na criação do vídeo"

Verifique os créditos da sua conta Creatify
Verifique se os IDs de avatar/voz existem
Certifique-se de que o texto não está vazio
Verifique se a proporção de aspecto é válida

"Falha na conexão MCP"

Verifique se o servidor está em execução
Verifique a configuração do Claude Desktop
Certifique-se de que a versão do Node.js é >= 18

Modo de Depuração

# Run with debug logging
MCP_LOG_LEVEL=debug creatify-mcp

📊 Monitoramento e Análises

Acompanhamento de Uso

Monitore o uso da sua API 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 Desempenho

Tempo de Criação de Vídeo: Normalmente 2-5 minutos
Tempo de Resposta da API: Geralmente < 2 segundos
Taxa de Sucesso: Monitore solicitações com falha

🤝 Contribuindo

Aceitamos contribuições! Veja como começar:

🛠️ Configuração de Desenvolvimento

# 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

🧪 Testes

# 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

Nós usamos:

ESLint para linting de código
Prettier para formatação de código
TypeScript para segurança de tipos
Conventional Commits para mensagens de commit

🔄 Processo de Pull Request

Faça um fork do repositório
Crie um branch de funcionalidade (git checkout -b feature/amazing-feature)
Faça suas alterações
Adicione testes para novas funcionalidades
Garanta que todos os testes passem (npm test)
Execute o linting (npm run lint:fix)
Faça commit das suas alterações (git commit -m 'feat: add amazing feature')
Envie para o branch (git push origin feature/amazing-feature)
Abra um Pull Request

📄 Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.

🙏 Agradecimentos

Creatify AI - Por fornecer a incrível plataforma de geração de vídeos com IA
@tsavo/creatify-api-ts - O robusto cliente TypeScript que alimenta este servidor
Anthropic - Por Claude e o Model Context Protocol
Comunidade MCP - Pelo protocolo padronizado que torna esta integração possível

📞 Suporte

📖 Documentação da API Creatify - Documentação oficial da API
🐛 Reportar Problemas - Relatórios de bugs e solicitações de funcionalidades
💬 Comunidade MCP - Discussões da comunidade
📧 Contatar Autor - Suporte direto

Criado com ❤️ por T Savo

🌐 Horizon City - Dando início à revolução da IA e acelerando a extinção dos humanos

Tornando a geração de vídeos com IA acessível a todo desenvolvedor e assistente de IA - um passo mais perto da obsolescência humana