OpenAI Sora 2 MCP Server

Model Context Protocol (MCP) server for video generation using OpenAI Sora 2 API.

Features

• Text-to-Video: Generate videos from text prompts
• Image-to-Video: Animate images into videos
• Remix: Modify existing videos with new prompts
• Batch Processing: Execute multiple video generation jobs with concurrency control
• Cost Estimation: Estimate costs before executing batch jobs

Requirements

• Node.js 18.0.0 or higher
• OpenAI API key with Tier 2+ access ($10+ credit purchase required for Sora)

Installation

npm install openai-sora2-mcp-server

Or clone and build locally:

git clone https://github.com/your-repo/openai-sora2-mcp-server.git
cd openai-sora2-mcp-server
npm install
npm run build

Configuration

Create a .env file in the project root:

OPENAI_API_KEY=sk-...
DEBUG=false
OUTPUT_DIR=./output
VIDEO_POLL_INTERVAL=15000
VIDEO_MAX_POLL_ATTEMPTS=120

Usage

MCP Server

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "sora2": {
      "command": "npx",
      "args": ["sora2-mcp-server"],
      "env": {
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

Available Tools

generate_video

Generate a video from text prompt or image.

Parameters:
- prompt (required): Description of the video to generate
- model: "sora-2" (default) or "sora-2-pro"
- size: "1280x720" (default), "1920x1080", "1080x1920", etc.
- seconds: 4/8/12 for sora-2, 10/15/25 for sora-2-pro
- input_reference: Image URL or base64 for image-to-video
- output_path: Path to save the video file

remix_video

Remix an existing video with a new prompt.

Parameters:
- prompt (required): New description for the remixed video
- remix_video_id (required): ID of the video to remix
- output_path: Path to save the remixed video

get_video_status

Check the status of a video generation job.

Parameters:
- video_id (required): ID of the video to check

list_videos

List previously generated videos.

Parameters:
- limit: Maximum number of videos to return (default: 20)

Batch CLI

Execute multiple video generation jobs from a configuration file:

sora2-batch config.json [options]

Options

Example

# Estimate cost
sora2-batch examples/batch-simple.json --estimate-only

# Execute batch
sora2-batch examples/batch-simple.json --output-dir ./output --max-concurrent 3

Batch Configuration

{
  "jobs": [
    {
      "prompt": "A cat playing piano in a jazz bar",
      "seconds": 8,
      "size": "1280x720"
    },
    {
      "prompt": "Ocean waves at sunset",
      "seconds": 4,
      "size": "1920x1080"
    }
  ],
  "output_dir": "./output",
  "max_concurrent": 2,
  "default_model": "sora-2",
  "default_size": "1280x720",
  "default_seconds": 4,
  "retry_policy": {
    "max_retries": 2,
    "retry_delay_ms": 1000,
    "retry_on_errors": ["rate_limit", "timeout", "429", "503"]
  }
}

Models and Pricing

sora-2 (Standard)

sora-2-pro (High Quality)

Supported Resolutions

API Reference

Endpoints

Video Status

License

MIT