> ## 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.

# Sora MCP интеграционное руководство

> sora MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) — это протокол контекста модели, разработанный компанией Anthropic, который позволяет AI моделям (таким как Claude, GPT и др.) вызывать внешние инструменты через стандартизированный интерфейс. С помощью Sora MCP Server, предоставляемого XHuoAPI, вы можете напрямую использовать OpenAI Sora для генерации AI видео в таких AI клиентах, как Claude Desktop, VS Code, Cursor и др.

## Обзор функций

Sora MCP Server предоставляет следующие основные функции:

* **Генерация видео из текста** — создание высококачественного видео на основе текстовых подсказок
* **Генерация видео из изображений** — создание видео на основе изображений
* **Генерация видео с согласованностью персонажей** — поддержание согласованности персонажей с помощью эталонных изображений
* **Асинхронная генерация** — поддержка асинхронной отправки задач и запроса результатов
* **Различные ориентации экрана** — поддержка альбомной (landscape) и портретной (portrait) ориентации
* **Запрос задач** — мониторинг процесса генерации и получение результатов

## Предварительная подготовка

Перед использованием вам необходимо получить XHuoAPI API Token:

1. Зарегистрируйтесь или войдите на [платформу XHuoAPI](https://api.xhuoapi.ai)
2. Перейдите на страницу [Sora Videos API](https://api.xhuoapi.ai/documents/sora-videos)
3. Нажмите «Acquire», чтобы получить API Token (при первом запросе предоставляется бесплатный лимит)

## Установка и настройка

### Способ 1: установка через pip (рекомендуется)

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

### Способ 2: установка из исходного кода

```bash theme={null}
git clone https://github.com/XHuoAPI/SoraMCP.git
cd SoraMCP
pip install -e .
```

После завершения установки вы можете использовать команду `mcp-sora` для запуска сервиса.

## Использование в Claude Desktop

Отредактируйте файл конфигурации Claude Desktop:

* **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

Добавьте следующую конфигурацию:

```json theme={null}
{
  "mcpServers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}
```

Если вы используете `uvx` (не требуется предварительная установка пакета):

```json theme={null}
{
  "mcpServers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}
```

Сохраните конфигурацию и перезапустите Claude Desktop, чтобы использовать инструменты Sora в диалоге.

## Использование в VS Code / Cursor

Создайте файл `.vscode/mcp.json` в корневом каталоге проекта:

```json theme={null}
{
  "servers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}
```

Или используйте `uvx`:

```json theme={null}
{
  "servers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}
```

## Список доступных инструментов

| Название инструмента                 | Описание                                                                         |
| ------------------------------------ | -------------------------------------------------------------------------------- |
| `sora_generate_video`                | Генерация видео из текстовых подсказок                                           |
| `sora_generate_video_from_image`     | Генерация видео на основе изображений                                            |
| `sora_generate_video_with_character` | Генерация согласованного видео с использованием эталонных изображений персонажей |
| `sora_generate_video_async`          | Асинхронная отправка задач на генерацию видео                                    |
| `sora_get_task`                      | Запрос статуса одной задачи                                                      |
| `sora_get_tasks_batch`               | Пакетный запрос статусов задач                                                   |

## Примеры использования

После завершения настройки вы можете напрямую вызывать эти функции на естественном языке в AI клиенте, например:

* «Помоги мне сгенерировать видео, где котик бегает по траве с помощью Sora»
* «Сгенерируй видео на основе этой фотографии человека, сохранив согласованность персонажа»
* «Сгенерируй вертикальное видео с содержанием о восходе солнца в городе»
* «Асинхронно сгенерируй видео и позже запроси результат»

## Дополнительная информация

* Репозиторий на GitHub: [XHuoAPI/SoraMCP](https://github.com/XHuoAPI/SoraMCP)
* Пакет PyPI: [mcp-sora](https://pypi.org/project/mcp-sora/)
* Документация API: [API для генерации видео Sora](https://api.xhuoapi.ai/documents/sora)