Sora MCP Guia de Integração

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 através de interfaces padronizadas. Através do Sora MCP Server fornecido pela AceData Cloud, você pode usar diretamente o OpenAI Sora para gerar vídeos de IA em clientes de IA como Claude Desktop, VS Code, Cursor, entre outros.

Visão Geral das Funcionalidades

O Sora 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
Vídeo com consistência de personagem — Mantém a consistência do personagem usando imagens de referência
Geração assíncrona — Suporta envio de tarefas assíncronas e consulta de resultados
Vários formatos de tela — Suporta paisagem (landscape) e retrato (portrait)
Consulta de tarefas — Monitora o progresso da geração e obtém resultados

Preparativos

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

Registre-se ou faça login na plataforma AceData Cloud
Vá para a página Sora Videos API
Clique em “Acquire” para obter o Token da API (o primeiro pedido oferece um crédito gratuito)

Instalação e Configuração

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

pip install mcp-sora

Método 2: Instalação a partir do código-fonte

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

Após a instalação, você pode usar o comando mcp-sora para iniciar o serviço.

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

Se usar uvx (sem necessidade de instalar pacotes previamente):

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

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

Usando no VS Code / Cursor

Crie um arquivo .vscode/mcp.json no diretório raiz do projeto:

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

Ou use uvx:

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

Lista de Ferramentas Disponíveis

Nome da Ferramenta	Descrição
`sora_generate_video`	Gera vídeo a partir de prompts de texto
`sora_generate_video_from_image`	Gera vídeo com base em imagens
`sora_generate_video_with_character`	Gera vídeo consistente usando imagens de referência
`sora_generate_video_async`	Envia tarefas de geração de vídeo de forma assíncrona
`sora_get_task`	Consulta o status de uma única tarefa
`sora_get_tasks_batch`	Consulta o status de várias tarefas

Exemplos de Uso

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

“Ajude-me a gerar um vídeo de um gato correndo na grama com o Sora”
“Gere um vídeo a partir desta foto de uma pessoa, mantendo a consistência do personagem”
“Gere um vídeo em formato retrato, com o conteúdo sendo o nascer do sol na cidade”
“Gere um vídeo de forma assíncrona e consulte os resultados mais tarde”

Mais Informações

Repositório no GitHub: AceDataCloud/SoraMCP
Pacote PyPI: mcp-sora
Documentação da API: API de Geração de Vídeos Sora

​Visão Geral das Funcionalidades

​Preparativos

​Instalação e Configuração

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

​Método 2: Instalação a partir do código-fonte

​Usando no Claude Desktop

​Usando no VS Code / Cursor

​Lista de Ferramentas Disponíveis

​Exemplos de Uso

​Mais Informações