Sora 2 MCP 服务器
模型上下文协议（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（必填）：输入图像的路径或URLduration（可选）：淡入淡出动画的持续时间，单位为秒（默认：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 clubClaude 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故障排除
“组织未验证”错误
- 访问 platform.openai.com/settings/organization/general（中文可表述为：前往 openai 平台的设置页面，选择“组织”下的“常规”选项）
- 点击“验证组织”
- 等待最多15分钟以使访问权限生效
API端点错误
Sora 2 API可能仍处于测试阶段。在使用API之前，请确保您的OpenAI帐户已通过sora.com的网页界面访问了Sora 2模型。
许可证
麻省理工学院（MIT）