Vidu MCP

Acesse os modelos mais recentes de geração de vídeo da Vidu através do Model Context Protocol (MCP).

GitHub
5
Experimente este MCPPatrocinado

Documentação

Vidu MCP

Uma ferramenta que permite acessar os modelos mais recentes de geração de vídeo da Vidu por meio de aplicativos que suportam o Model Context Protocol (MCP), como Claude ou Cursor.

中文文档

Visão Geral

Vidu MCP é uma ferramenta que permite acessar os modelos mais recentes de geração de vídeo da Vidu por meio de aplicativos que suportam o Model Context Protocol (MCP), como Claude ou Cursor. Essa integração permite gerar vídeos de alta qualidade a qualquer hora, em qualquer lugar — incluindo texto-para-vídeo, imagem-para-vídeo e muito mais.

Principais Recursos

  • Geração de Texto-para-Vídeo: Gere vídeos criativos usando prompts de texto
  • Geração de Imagem-para-Vídeo: Gere vídeos criativos usando prompts de texto e imagem
  • Geração de Referência-para-Vídeo: Gere vídeos criativos usando prompts de texto e imagem
  • Geração de Início-Fim-para-Vídeo: Gere vídeos criativos usando prompts de texto e imagem

Componentes do Sistema

O sistema consiste em dois componentes principais:

  1. UVX MCP Server
    • Servidor em nuvem baseado em Python
    • Comunica-se diretamente com a API da Vidu
    • Oferece recursos completos de geração de vídeo

Instalação e Configuração

Pré-requisitos

  1. Python 3.10 ou superior
  2. UV/UVX
  3. Chave da API Vidu: Obtenha na Plataforma Vidu (Este recurso requer Créditos de API, que devem ser adquiridos separadamente na Plataforma Vidu

Obter Dependências

  1. Python:

    • Baixe e instale a partir do site oficial do Python
    • Certifique-se de que o Python foi adicionado ao caminho do sistema

  2. UV/UVX:

    • Instale o uv e configure nosso projeto e ambiente Python:

Mac/Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Como Usar o Servidor MCP

1. Obtenha a Chave da API Vidu

  • Visite a Plataforma Vidu
  • Registre-se ou faça login na sua conta
  • Crie e copie sua chave de API nas configurações da conta

2. Baixe as Dependências Necessárias

  • Python: Instale Python 3.10 ou superior
  • UV/UVX: Instale a versão estável mais recente do UV & UVX

3. Configure o Cliente MCP

  • Abra seu cliente MCP (ex.: Claude for Desktop ou Cursor)
  • Localize as configurações do cliente
  • Abra o mcp_config.json (ou o arquivo de configuração relevante)
  • Adicione a configuração de acordo com o método que você usa:
{
  "mcpServers": {
    "Vidu": {
      "command": "uvx",
      "args": [
        "vidu-mcp"
      ],
      "env": {
        "VIDU_API_KEY": "api-key-here", 
        "VIDU_API_HOST": "api-host-here"
      }
    }
  }
}
  • Salve o arquivo de configuração

4. Reinicie o Cliente MCP ou Atualize o Servidor MCP

  • Feche e reabra completamente o seu cliente MCP
  • Ou use a opção "Atualizar Servidor MCP" se houver suporte

Configuração Específica por Cliente

Claude for Desktop

  1. Abra o aplicativo Claude
  2. Navegue até Claude > Configurações > Desenvolvedor > Editar Config
  3. Abra o arquivo claude_desktop_config.json
    • Windows
    • Mac : ~/Library/Application\ Support/Claude/claude_desktop_config.json
  4. Adicione a configuração acima e salve
  5. Reinicie o Claude
    • Se conectado com sucesso: a página inicial não mostrará nenhum erro e o status do MCP ficará verde
    • Se a conexão falhar: uma mensagem de erro será exibida na página inicial

Cursor

  1. Abra o aplicativo Cursor
  2. Vá para Configurações > Model Context Protocol
  3. Adicione um novo servidor
  4. Preencha os detalhes do servidor conforme a configuração JSON acima
  5. Salve e reinicie ou atualize o servidor MCP

Exemplos de Uso

Texto-para-Vídeo

Use prompts em linguagem natural via Claude ou Cursor para gerar vídeos.

Exemplo Básico:

In an ultra-realistic fashion photography style featuring light blue and pale amber tones, an astronaut in a spacesuit walks through the fog. The background consists of enchanting white and golden lights, creating a minimalist still life and an impressive panoramic scene.

Exemplo Avançado com Parâmetros:

Generate a night cityscape video with the following parameters:
Prompt: Skyscraper lights twinkling under the night sky, with car lights forming streaks on the road
Model: viduq1
Style: general
Duration: 5 seconds
Aspect Ratio: 16:9
Resolution: 1080p
Movement Amplitude: middle

FAQ

Como obtenho uma chave de API da Vidu?

  • Registre-se na Plataforma Vidu e gere-a em "API-KEY" na sua conta.

O que devo fazer se o servidor não responder?

  1. Verifique se sua chave de API é válida
  2. Consulte os logs de erro (normalmente nas pastas de log do Claude ou Cursor)

Como obter créditos?

  • Se você ainda não recarregou na plataforma de API, faça isso primeiro. Plataforma Vidu

Onde posso encontrar o vídeo gerado?

  • Você receberá um link de URL para visualizar, baixar ou compartilhar o vídeo.

Quanto tempo leva a geração de vídeo?

  • Normalmente de 30 segundos a 5 minutos, dependendo da complexidade, da carga do servidor e das condições de rede.

O que fazer se você encontrar um erro spawn uvx ENOENT?

  • Esse erro geralmente é causado por caminhos de instalação incorretos do UV/UVX. Você pode resolvê-lo da seguinte forma:

Para Mac/Linux:

sudo cp ./uvx /usr/local/bin

Para Windows:

  1. Identifique o caminho de instalação do UV/UVX executando o seguinte comando no terminal:
where uvx
  1. Abra o Explorador de Arquivos e localize os arquivos uvx/uv.
  2. Mova os arquivos para um dos seguintes diretórios:
    • C:\Program Files (x86) ou C:\Program Files

Suporte

Suporte Técnico