Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt

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

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