Перейти к основному содержанию
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:
  1. Зарегистрируйтесь или войдите на платформу AceData Cloud
  2. Перейдите на страницу Sora Videos API
  3. Нажмите «Acquire», чтобы получить API Token (при первом запросе предоставляется бесплатный лимит)

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

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

pip install mcp-sora

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

git clone https://github.com/AceDataCloud/MCPSora.git
cd MCPSora
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»
  • «Сгенерируй видео на основе этой фотографии человека, сохранив согласованность персонажа»
  • «Сгенерируй вертикальное видео с содержанием о восходе солнца в городе»
  • «Асинхронно сгенерируй видео и позже запроси результат»

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