Guia de Integração Seedance MCP

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 Seedance MCP Server fornecido pela AceData Cloud, você pode usar diretamente a geração de vídeos de IA da Seedance da ByteDance em clientes de IA como Claude Desktop, VS Code, Cursor, entre outros.

Visão Geral das Funcionalidades

O Seedance 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 com base em imagens de referência (modos de primeiro quadro, último quadro, imagem de referência, etc.)
Suporte a múltiplos modelos — suporta modelos Seedance 1.5 Pro, 1.0 Pro, 1.0 Lite e outros
Diversas resoluções — suporta resoluções 480p, 720p, 1080p, entre outras
Várias proporções de tela — suporta proporções 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, etc.
Duração flexível — suporta vídeos com duração de 2 a 12 segundos
Geração de áudio — alguns modelos suportam geração simultânea de áudio
Consulta de tarefas — monitora o progresso da geração e obtém resultados

Preparação Prévia

Antes de usar, você precisa obter o Token da API da AceData Cloud:

Registre-se ou faça login na plataforma AceData Cloud
Acesse a página da Seedance Videos API
Clique em “Acquire” para obter o Token da API (a primeira solicitação oferece um crédito gratuito)

Instalação e Configuração

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

pip install mcp-seedance

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

git clone https://github.com/AceDataCloud/SeedanceMCP.git
cd SeedanceMCP
pip install -e .

Após a instalação, você pode iniciar o serviço com o comando mcp-seedance.

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": {
    "seedance": {
      "command": "mcp-seedance",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "seu API Token"
      }
    }
  }
}

Se usar uvx (não requer instalação prévia de pacotes):

{
  "mcpServers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "seu API Token"
      }
    }
  }
}

Salve a configuração e reinicie o Claude Desktop para usar as ferramentas Seedance nas conversas.

Uso no VS Code / Cursor

Crie .vscode/mcp.json na raiz do projeto:

{
  "servers": {
    "seedance": {
      "command": "mcp-seedance",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "seu API Token"
      }
    }
  }
}

Ou use uvx:

{
  "servers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "seu API Token"
      }
    }
  }
}

Lista de Ferramentas Disponíveis

Nome da Ferramenta	Descrição
`seedance_generate_video`	Gera vídeo a partir de prompt de texto
`seedance_generate_video_from_image`	Gera vídeo com base em imagem de referência
`seedance_get_task`	Consulta o status de uma tarefa única
`seedance_get_tasks_batch`	Consulta o status de múltiplas tarefas
`seedance_list_models`	Lista todos os modelos disponíveis e suas capacidades
`seedance_list_resolutions`	Lista resoluções e proporções de tela disponíveis
`seedance_list_actions`	Lista todas as ferramentas e exemplos de fluxos de trabalho

Exemplos de Uso

Após a configuração, você pode chamar essas funcionalidades diretamente em linguagem natural nos clientes de IA, por exemplo:

“Me ajude a gerar um vídeo de time-lapse de rua da cidade com Seedance”
“Use esta foto como primeiro quadro para gerar um vídeo de 8 segundos”
“Gere um vídeo curto em 1080p na orientação vertical 9:16”
“Gere um vídeo com áudio usando o modelo Seedance 1.5 Pro”

Mais Informações

Repositório GitHub: AceDataCloud/SeedanceMCP
Pacote PyPI: mcp-seedance
Documentação da API: Seedance Vídeo API

​Visão Geral das Funcionalidades

​Preparação Prévia

​Instalação e Configuração

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

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

​Uso no Claude Desktop

​Uso no VS Code / Cursor

​Lista de Ferramentas Disponíveis

​Exemplos de Uso

​Mais Informações