Guía de Integración de Sora MCP

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:

Regístrate o inicia sesión en la plataforma AceData Cloud
Ve a la página de API de Videos Sora
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/SoraMCP.git
cd SoraMCP
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 herramienta	Descripción
`sora_generate_video`	Genera videos a partir de indicaciones de texto
`sora_generate_video_from_image`	Genera videos basados en imágenes
`sora_generate_video_with_character`	Genera videos consistentes usando imágenes de referencia
`sora_generate_video_async`	Presenta tareas de generación de video de forma asíncrona
`sora_get_task`	Consulta el estado de una tarea individual
`sora_get_tasks_batch`	Consulta 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

Repositorio de GitHub: AceDataCloud/SoraMCP
Paquete de PyPI: mcp-sora
Documentación de la API: API de generación de videos Sora

​Resumen de Funciones

​Preparativos Previos

​Instalación y Configuración

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

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

​Uso en Claude Desktop

​Uso en VS Code / Cursor

​Lista de Herramientas Disponibles

​Ejemplos de Uso

​Más Información