Vidu MCP Server

Gere vídeos a partir de imagens e gerencie tarefas usando a API de geração de vídeos Vidu.

Documentação

Vidu MCP Server

Este é um servidor Model Context Protocol (MCP) para integração com a API de geração de vídeo da Vidu. Ele fornece ferramentas para gerar vídeos a partir de imagens usando os poderosos modelos de IA da Vidu.

Recursos

Conversão de imagem em vídeo: Gere vídeos a partir de imagens estáticas com configurações personalizáveis
- Suporte a múltiplos modelos: viduq1, vidu1.5, vidu2.0
- Restrições de duração e resolução específicas por modelo
- Suporte a música de fundo para vídeos de 4 segundos
- Suporte a URL de callback para notificações assíncronas
Verificação de status de geração: Monitore o progresso das tarefas de geração de vídeo com informações de uso de créditos
Upload de imagens: Envie imagens facilmente para uso na API da Vidu (máximo de 10MB)

Pré-requisitos

Node.js (v14 ou superior)
Chave da API Vidu (obtenha no site da Vidu)
TypeScript (para desenvolvimento)

Instalação

Instalação via Smithery

Instale automaticamente o Vidu Video Generation Server para Claude Desktop usando o Smithery:

npx -y @smithery/cli install @el-el-san/vidu-mcp-server --client claude

Configuração do Gemini CLI

Para usar com o Gemini CLI, adicione a configuração do servidor em ~/.gemini/settings.json:

{
  "mcpServers": {
    "vidu": {
      "command": "node",
      "args": [
        "your_path/vidu-mcp-server/build/index.js"
      ],
      "env": {
        "VIDU_API_KEY": "your_api_key_here"
      }
    }
  }
}

Observação: Substitua your_path pelo caminho do seu diretório de instalação real e your_api_key_here pela sua chave da API Vidu.

Instalação manual

Clone este repositório:

git clone https://github.com/el-el-san/vidu-mcp-server.git
cd vidu-mcp-server

Instale as dependências:

npm install

Crie o arquivo .env com base em .env.template e adicione sua chave da API Vidu:

VIDU_API_KEY=your_api_key_here

Como usar

Para Gemini CLI

Compile o código TypeScript:

npm run build

Configure na configuração do Gemini CLI (consulte a seção Configuração do Gemini CLI acima)
Reinicie o Gemini CLI para carregar o MCP

Ferramentas

1. Conversão de imagem em vídeo

Converte uma imagem estática em vídeo com parâmetros personalizáveis.

Parâmetros:

image_url (obrigatório): URL da imagem a ser convertida em vídeo
prompt (opcional): Prompt de texto para geração do vídeo (máximo de 1500 caracteres)
duration (opcional): Duração do vídeo de saída em segundos (específica por modelo)
- viduq1: apenas 5 segundos
- vidu1.5/vidu2.0: 4 ou 8 segundos (padrão: 4 segundos)
model (opcional): Nome do modelo de geração ("viduq1", "vidu1.5", "vidu2.0", padrão "vidu2.0")
resolution (opcional): Resolução do vídeo de saída (específica por modelo/duração)
- viduq1 (5s): apenas 1080p
- vidu1.5/vidu2.0 (4s): "360p", "720p", "1080p" (padrão "360p")
- vidu1.5/vidu2.0 (8s): apenas "720p"
movement_amplitude (opcional): Amplitude de movimento dos objetos no quadro ("auto", "small", "medium", "large", padrão "auto")
seed (opcional): Semente aleatória para reprodutibilidade
bgm (opcional): Adicionar música de fundo ao vídeo (booleano, padrão false, apenas para vídeos de 4 segundos)
callback_url (opcional): URL para notificação assíncrona quando o status de geração mudar

Exemplo de solicitação:

{
  "image_url": "https://example.com/image.jpg",
  "prompt": "山を背景にした静かな湖",
  "duration": 8,
  "model": "vidu2.0",
  "resolution": "720p",
  "movement_amplitude": "medium",
  "seed": 12345,
  "bgm": false
}

2. Verificação de status de geração

Verifica o status de uma tarefa de geração de vídeo em andamento.

Parâmetros:

task_id (obrigatório): ID da tarefa retornado pela ferramenta de conversão de imagem em vídeo

Exemplo de solicitação:

{
  "task_id": "12345abcde"
}

3. Upload de imagem

Envia uma imagem para uso na API da Vidu.

Parâmetros:

image_path (obrigatório): Caminho local do arquivo de imagem
image_type (obrigatório): Tipo do arquivo de imagem ("png", "webp", "jpeg", "jpg")

Exemplo de solicitação:

{
  "image_path": "/path/to/your/image.jpg",
  "image_type": "jpg"
}

Solução de problemas

Problemas com a chave da API: Verifique se a chave da API Vidu está configurada corretamente no arquivo .env (para configuração manual) ou na configuração do Gemini CLI (para configuração via Gemini CLI)
Erros de upload de arquivo: Verifique se o arquivo de imagem é válido e está dentro do limite de tamanho (10MB para a ferramenta upload-image, até 50MB para imagens via URL direta)
Problemas de conexão: Verifique se você tem acesso à internet e consegue alcançar os servidores da API Vidu
Problemas com o Gemini CLI:
- Verifique se o servidor foi compilado (npm run build) antes de configurar no Gemini CLI
- Verifique se o caminho no settings.json aponta para o arquivo build/index.js correto
- Reinicie o Gemini CLI após alterações na configuração
- Defina "disabled": false na configuração do servidor