> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Guía de Integración de Sora MCP

> sora MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) 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 XHuoAPI, 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 XHuoAPI:

1. Regístrate o inicia sesión en la [plataforma XHuoAPI](https://api.xhuoapi.ai)
2. Ve a la página de [API de Videos Sora](https://api.xhuoapi.ai/documents/sora-videos)
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)

```bash theme={null}
pip install mcp-sora
```

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

```bash theme={null}
git clone https://github.com/XHuoAPI/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:

```json theme={null}
{
  "mcpServers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "XHuoAPI_API_TOKEN": "tu Token de API"
      }
    }
  }
}
```

Si usas `uvx` (sin necesidad de instalar paquetes previamente):

```json theme={null}
{
  "mcpServers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "XHuoAPI_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:

```json theme={null}
{
  "servers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "XHuoAPI_API_TOKEN": "tu Token de API"
      }
    }
  }
}
```

O usa `uvx`:

```json theme={null}
{
  "servers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "XHuoAPI_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: [XHuoAPI/SoraMCP](https://github.com/XHuoAPI/SoraMCP)
* Paquete de PyPI: [mcp-sora](https://pypi.org/project/mcp-sora/)
* Documentación de la API: [API de generación de videos Sora](https://api.xhuoapi.ai/documents/sora)