Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

MCP (Model Context Protocol) é um protocolo de contexto de modelo lançado pela Anthropic, que permite que modelos de IA (como Claude, GPT, etc.) chamem ferramentas externas por meio de uma interface padronizada. Com o Veo MCP Server fornecido pela XHuoAPI, você pode usar diretamente o Google Veo para gerar vídeos de IA em clientes de IA como Claude Desktop, VS Code, Cursor, entre outros.

​
Visão Geral das Funcionalidades

O Veo MCP Server oferece as seguintes funcionalidades principais:
  • Geração de vídeo a partir de texto — gera vídeos de alta qualidade a partir de prompts de texto
  • Geração de vídeo a partir de imagem — gera vídeos baseados em imagens
  • Suporte a múltiplos modelos — suporta modelos como veo3, veo2, veo31-fast-ingredients, etc.
  • Diversas resoluções — suporta formatos de saída como 4K, 1080p, GIF, entre outros
  • Diversas proporções de tela — suporta proporções como 16:9, 9:16, etc.
  • Upgrade para 1080p — atualiza vídeos já gerados para 1080p
  • Consulta de tarefas — monitora o progresso da geração e obtém resultados

​
Pré-requisitos

Antes de usar, você precisa obter o Token da API da XHuoAPI:
  1. Registre-se ou faça login na plataforma XHuoAPI
  2. Acesse a página Veo Videos API
  3. Clique em “Acquire” para obter o Token da API (a primeira solicitação concede uma cota gratuita)

​
Instalação e Configuração

​
Método 1: Instalação via pip (recomendado)

pip install mcp-veo

​
Método 2: Instalação via código-fonte

git clone https://github.com/XHuoAPI/VeoMCP.git
cd VeoMCP
pip install -e .
Após a instalação, você pode iniciar o serviço com o comando mcp-veo.

​
Uso no Claude Desktop

Edite o arquivo de configuração do Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Adicione a seguinte configuração: 
{
  "mcpServers": {
    "veo": {
      "command": "mcp-veo",
      "env": {
        "XHuoAPI_API_TOKEN": "seu API Token"
      }
    }
  }
}
Se usar uvx (sem necessidade de instalar pacotes previamente): 
{
  "mcpServers": {
    "veo": {
      "command": "uvx",
      "args": ["mcp-veo"],
      "env": {
        "XHuoAPI_API_TOKEN": "seu API Token"
      }
    }
  }
}
Após salvar a configuração, reinicie o Claude Desktop para usar as ferramentas Veo nas conversas.

​
Uso no VS Code / Cursor

Crie o arquivo .vscode/mcp.json na raiz do projeto: 
{
  "servers": {
    "veo": {
      "command": "mcp-veo",
      "env": {
        "XHuoAPI_API_TOKEN": "seu API Token"
      }
    }
  }
}
Ou use uvx: 
{
  "servers": {
    "veo": {
      "command": "uvx",
      "args": ["mcp-veo"],
      "env": {
        "XHuoAPI_API_TOKEN": "seu API Token"
      }
    }
  }
}

​
Lista de Ferramentas Disponíveis

Nome da FerramentaDescrição
veo_text_to_videoGera vídeo a partir de prompt de texto
veo_image_to_videoGera vídeo baseado em imagem
veo_get_1080pAtualiza vídeo para 1080p
veo_get_taskConsulta o status de uma tarefa
veo_get_tasks_batchConsulta status de múltiplas tarefas

​
Exemplos de Uso

Após a configuração, você pode chamar essas funcionalidades diretamente em clientes de IA usando linguagem natural, por exemplo:
  • “Ajude-me a gerar um vídeo time-lapse do céu estrelado com Veo”
  • “Use esta foto de paisagem para gerar um vídeo 4K”
  • “Gere um vídeo curto em formato vertical 9:16”
  • “Atualize este vídeo para 1080p”

​
Mais Informações