Sora 2 MCP Server

Sora 2 MCP 服务器

](https://www.npmjs.com/package/sora-2-mcp-server) 

模型上下文协议（MCP）服务器，用于OpenAI的Sora 2视频生成API。直接从Claude Code或任何兼容MCP的客户端生成专业AI视频、合并片段并创建淡入动画。

特点/功能

• 视频生成使用Sora 2或Sora 2 Pro根据文本提示创建视频
• 视频合并使用FFmpeg合并多个视频文件
• 渐隐动画从静态图像中创建淡入/淡出/淡入淡出效果
• 状态监控实时监控视频生成进度
• 作业管理列出并删除视频生成作业
• 灵活参数控制分辨率（720p至4K）、时长（4-12秒）以及模型选择

先决条件

• Node.js 18及以上版本
• 拥有Sora 2访问权限的OpenAI API密钥
• 在OpenAI平台上验证的组织（访问Sora所必需）
• FFmpeg（可选，用于视频合并和淡入淡出动画功能）

安装

npm install -g sora-2-mcp-server

或者使用 npx（无需安装）：

npx sora-2-mcp-server

配置

添加到Claude代码中

将此服务器添加到您的Claude Code MCP设置中（~/.config/claude-code/mcp_settings.json):

{
  "mcpServers": {
    "sora-2": {
      "command": "npx",
      "args": ["-y", "sora-2-mcp-server"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

或者如果全局安装：

{
  "mcpServers": {
    "sora-2": {
      "command": "sora-2-mcp-server",
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

可用工具

1. 创建视频

使用Sora 2或Sora 2 Pro生成视频。

参数：

• prompt （必填）：视频的文字描述
• model （可选）：“sora-2”或“sora-2-pro”（默认：“sora-2”）
• size （可选）：分辨率 - “1280x720”，“720x1280”，“1792x1024”，或“1024x1792”（默认：“1280x720”）
• seconds （可选）：持续时间 - “4”、“8”或“12”（默认：“8”）

示例：

{
  "prompt": "A serene sunset over a mountain lake with gentle waves",
  "model": "sora-2-pro",
  "size": "1792x1024",
  "seconds": "12"
}

2. 获取视频状态

检查视频生成作业的状态。

参数：

• video_id （必需）：视频生成作业的ID

示例：

{
  "video_id": "vid_abc123"
}

3. 列出视频

列出所有视频生成任务。

参数：

• limit （可选）：要返回的视频最大数量（默认：20）
• after （可选）：用于分页的游标

示例：

{
  "limit": 10
}

4. 删除视频

删除一个视频生成任务。

参数：

• video_id （必填）：要删除的视频的ID

示例：

{
  "video_id": "vid_abc123"
}

5. 合并视频

使用FFmpeg将多个视频文件合并成一个无缝衔接的视频。

参数：

• video_urls （必需）：要合并的视频文件路径或URL的数组（按顺序）
• output_path （可选）：合并后的视频将保存的路径（默认：“merged_video.mp4”）

示例：

{
  "video_urls": [
    "/path/to/intro.mp4",
    "/path/to/main_content.mp4",
    "/path/to/outro.mp4"
  ],
  "output_path": "final_video.mp4"
}

注： 需要在您的系统上安装FFmpeg。

6. 创建淡入淡出动画

将静态图像转换为带有专业淡入淡出效果的动态视频片段。

参数：

• image_path （必填）：输入图像的路径或URL
• duration （可选）：淡入淡出动画的持续时间，单位为秒（默认：3）
• output_path （可选）：视频将保存的路径（默认：“fade_animation.mp4”）
• fade_type （可选）：淡入效果类型 - “in”（淡入）、“out”（淡出）或“in-out”（同时淡入淡出）（默认：“in”）

示例：

{
  "image_path": "/path/to/logo.png",
  "duration": 3,
  "fade_type": "in-out",
  "output_path": "logo_animation.mp4"
}

褪色类型：

• “in”从黑暗渐变为完全可见
• “out”从完全可见渐变为黑色
• “in-out” 翻译成中文是“进出”淡入，保持，然后淡出

注： 需要在您的系统上安装FFmpeg。

与Claude代码的使用

配置完成后，您可以在Claude Code中直接使用Sora 2工具：

Generate a video of a cat playing piano in a jazz club

Claude Code 将自动使用 create_video 用于生成视频的工具。

API访问说明

• Sora 2 API要求在platform.openai.com/settings/organization/general进行组织验证
• 经过验证，访问权限的传播可能需要长达15分钟的时间
• 定价（截至2025年10月9日）：

- Sora 2：每秒0.10-0.20美元 - Sora 2 Pro：0.30-0.50美元/秒

发展

# Watch mode for development
npm run watch

# Build for production
npm run build

故障排除

“组织未验证”错误

1. 访问 platform.openai.com/settings/organization/general（中文可表述为：前往 openai 平台的设置页面，选择“组织”下的“常规”选项）
2. 点击“验证组织”
3. 等待最多15分钟以使访问权限生效

API端点错误

Sora 2 API可能仍处于测试阶段。在使用API之前，请确保您的OpenAI帐户已通过sora.com的网页界面访问了Sora 2模型。

许可证

麻省理工学院（MIT）