Sora 2

MCP server exposing Sora 2 video generation, merging, and animation capabilities via MCP to enable easy control from clients.

typescript

1

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "writingmate-sora-2-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sora-2-mcp-server"
      ],
      "env": {
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY"
      }
    }
  }
}

You run a dedicated MCP server that exposes the Sora 2 video generation features to any MCP-compatible client. It lets you generate, merge, and animate videos from prompts, while giving real-time status and job management. This guide shows you how to install, configure, and use the server end-to-end.

How to use

You connect to the server from your MCP client or Claude Code by registering an MCP server configuration. Once set up, you can create videos from text prompts, check the status of ongoing jobs, list or delete past jobs, merge multiple videos with FFmpeg, and produce fade animations from static images. Use the functions to control model, resolution, and duration to fit your project.

Common usage patterns include: creating a video with specific model and size, monitoring progress in real time, and producing a final merged video from several clips. You can also generate fade animations from logos or images to introduce your videos. All operations are exposed through the MCP surface so you can orchestrate them from Claude Code or any MCP-compatible client.

How to install

Prerequisites you need before installing the MCP server:

Node.js 18 or newer
OpenAI API key with Sora 2 access
FFmpeg (optional for merging and fades)

Install the MCP server globally so you can run it from the command line:

npm install -g sora-2-mcp-server

Configure and run with MCP clients

If you are using Claude Code, add the MCP server configuration to your Claude Code MCP settings. You can run the server via npx for quick start or install it globally if you prefer a persistent CLI.

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

Run the server with npx or a local installation

If you installed the package locally or want to run it without a global install, start the server with npx.

npx sora-2-mcp-server

Available tools

create_video

Generate a video using Sora 2 or Sora 2 Pro with options for model, size, and duration.

get_video_status

Query the status of an active or completed video generation job by its video_id.

list_videos

List video generation jobs with optional pagination controls.

delete_video

Delete a video generation job by its video_id.

merge_videos

Concatenate multiple video files into a single video using FFmpeg.

create_fade_animation

Create a fade animation video from a static image with configurable duration and fade type.