跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt

Use this file to discover all available pages before exploring further.

MCP（Model Context Protocol） 是由 Anthropic 推出的模型上下文协议，允许 AI 模型（如 Claude、GPT 等）通过标准化接口调用外部工具。通过 AceData Cloud 提供的 Sora MCP Server，你可以在 Claude Desktop、VS Code、Cursor 等 AI 客户端中直接使用 OpenAI Sora 生成 AI 视频。

​
功能概览

Sora MCP Server 提供以下核心功能：
  • 文本生成视频 — 通过文本提示词生成高质量视频
  • 图片生成视频 — 以图片为基础生成视频
  • 角色一致性视频 — 使用参考图保持角色一致性
  • 异步生成 — 支持异步任务提交和结果查询
  • 多种画面方向 — 支持横屏（landscape）和竖屏（portrait）
  • 任务查询 — 监控生成进度并获取结果

​
前置准备

使用前，你需要获取 AceData Cloud API Token：
  1. 注册或登录 AceData Cloud 平台
  2. 前往 Sora Videos API 页面
  3. 点击「Acquire」获取 API Token（首次申请赠送免费额度）

​
安装配置

​
方式一：pip 安装（推荐）

pip install mcp-sora

​
方式二：源码安装

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 生成一段猫咪在草地上奔跑的视频」
  • 「用这张人物照片生成一段视频，保持角色一致」
  • 「生成一段竖屏的视频，内容是城市日出」
  • 「异步生成一段视频并稍后查询结果」

​
更多信息