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

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

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

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

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

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

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

Зарегистрируйтесь или войдите на платформу AceData Cloud
Перейдите на страницу Sora Videos API
Нажмите «Acquire», чтобы получить API Token (при первом запросе предоставляется бесплатный лимит)

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

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

pip install mcp-sora

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

git clone https://github.com/AceDataCloud/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

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

{
  "mcpServers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "ваш API Token"
      }
    }
  }
}

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

{
  "mcpServers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "ваш API Token"
      }
    }
  }
}

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

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

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

{
  "servers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "ваш API Token"
      }
    }
  }
}

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

{
  "servers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "ACEDATACLOUD_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: AceDataCloud/SoraMCP
Пакет PyPI: mcp-sora
Документация API: API для генерации видео Sora

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

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

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

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

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

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

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

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

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

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