Saltar al contenido principal
MCP (Model Context Protocol) es un protocolo de contexto de modelo lanzado por Anthropic, que permite a los modelos de IA (como Claude, GPT, etc.) llamar a herramientas externas a través de interfaces estandarizadas. A través del Sora MCP Server proporcionado por AceData Cloud, puedes usar OpenAI Sora para generar videos de IA directamente en clientes de IA como Claude Desktop, VS Code, Cursor, etc.

Resumen de Funciones

Sora MCP Server ofrece las siguientes funciones clave:
  • Generación de video a partir de texto — Genera videos de alta calidad a partir de indicaciones de texto
  • Generación de video a partir de imágenes — Genera videos basados en imágenes
  • Video con consistencia de personajes — Mantiene la consistencia de los personajes utilizando imágenes de referencia
  • Generación asíncrona — Soporta la presentación de tareas asíncronas y la consulta de resultados
  • Varias orientaciones de pantalla — Soporta horizontal (landscape) y vertical (portrait)
  • Consulta de tareas — Monitorea el progreso de generación y obtiene resultados

Preparativos Previos

Antes de usar, necesitas obtener el Token de API de AceData Cloud:
  1. Regístrate o inicia sesión en la plataforma AceData Cloud
  2. Ve a la página de API de Videos Sora
  3. Haz clic en “Acquire” para obtener el Token de API (se otorgan créditos gratuitos en la primera solicitud)

Instalación y Configuración

Método 1: Instalación con pip (recomendado)

pip install mcp-sora

Método 2: Instalación desde el código fuente

git clone https://github.com/AceDataCloud/MCPSora.git
cd MCPSora
pip install -e .
Una vez completada la instalación, puedes usar el comando mcp-sora para iniciar el servicio.

Uso en Claude Desktop

Edita el archivo de configuración de Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Agrega la siguiente configuración:
{
  "mcpServers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "tu Token de API"
      }
    }
  }
}
Si usas uvx (sin necesidad de instalar paquetes previamente):
{
  "mcpServers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "tu Token de API"
      }
    }
  }
}
Guarda la configuración y reinicia Claude Desktop para poder usar las herramientas relacionadas con Sora en la conversación.

Uso en VS Code / Cursor

Crea un archivo .vscode/mcp.json en el directorio raíz del proyecto:
{
  "servers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "tu Token de API"
      }
    }
  }
}
O usa uvx:
{
  "servers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "tu Token de API"
      }
    }
  }
}

Lista de Herramientas Disponibles

Nombre de la herramientaDescripción
sora_generate_videoGenera videos a partir de indicaciones de texto
sora_generate_video_from_imageGenera videos basados en imágenes
sora_generate_video_with_characterGenera videos consistentes usando imágenes de referencia
sora_generate_video_asyncPresenta tareas de generación de video de forma asíncrona
sora_get_taskConsulta el estado de una tarea individual
sora_get_tasks_batchConsulta el estado de tareas en lote

Ejemplos de Uso

Una vez configurado, puedes llamar a estas funciones directamente en el cliente de IA usando lenguaje natural, por ejemplo:
  • “Ayúdame a generar un video de un gato corriendo en el césped con Sora”
  • “Genera un video a partir de esta foto de una persona, manteniendo la consistencia del personaje”
  • “Genera un video vertical sobre el amanecer en la ciudad”
  • “Genera un video de forma asíncrona y consulta los resultados más tarde”

Más Información