OpenAIのSora 2 APIと統合し、動画生成とリミックスを行うモデルコンテキストプロトコル(MCP)サーバーです。

特徴

• 動画作成:Sora 2を使ってテキストプロンプトから動画を生成する
• リミックス動画:既存の動画のバリエーションを新しいプロンプトで作成
• ビデオステータス:ビデオ生成ジョブの状況と進捗を確認する

前提条件

• Node.js 18+
• Soraアクセス付きのOpenAI APIキー
• MCP互換クライアント(Claude、Cursor、VS Codeなど)

設置

1. リポジトリのクローン:

2. 依存関係のインストール:

3. プロジェクトを構築する:

4. Claude Desktopの設定:

• claude_desktop_config.example.jsonを[[T1]にコピーする]
• インストールディレクトリに一致するようにargsパスを更新する
• OpenAI APIキーをOPENAI_API_KEYフィールドに追加してください
• オプションでDOWNLOAD_DIRを希望のダウンロードフォルダに設定

サーバーアーキテクチャ

このプロジェクトには、異なるユースケース向けの2つのサーバー実装が含まれています。

📱 stdio-server.ts - クロードデスクトップ用

• Transport: stdio(標準入出力)
• ユースケース: ローカルプロセス通信

Sora MCP Server

A Model Context Protocol (MCP) server that integrates with OpenAI’s Sora 2 API for video generation and remixing.

Features

• Create Videos: Generate videos from text prompts using Sora 2
• Remix Videos: Create variations of existing videos with new prompts
• Video Status: Check the status and progress of video generation jobs

Prerequisites

• Node.js 18+
• OpenAI API key with Sora access
• An MCP-compatible client (Claude, Cursor, VS Code, etc.)

Installation

1. Clone the repository:

git clone https://github.com/Doriandarko/sora-mcp
cd sora-mcp

2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Configure for Claude Desktop:
   • Copy claude_desktop_config.example.json to ~/Library/Application Support/Claude/claude_desktop_config.json
   • Update the args path to match your installation directory
   • Add your OpenAI API key to the OPENAI_API_KEY field
   • Optionally set DOWNLOAD_DIR to your preferred download folder

Server Architecture

This project includes two server implementations for different use cases:

📱 stdio-server.ts - For Claude Desktop

• Transport: stdio (Standard Input/Output)
• Use case: Local process communication
• How it works: Claude Desktop spawns this as a child process
• Benefits: Fast, secure, no network needed
• Used by: Claude Desktop

🌐 server.ts - For Remote Access

• Transport: HTTP/Streamable HTTP
• Use case: Remote clients, web-based tools
• How it works: Runs as HTTP server on port 3000
• Benefits: Network accessible, multiple clients
• Used by: MCP Inspector, VS Code, Cursor, browsers

Why two servers? Different MCP clients use different transports. This separation keeps the code clean and optimized for each transport type.

Usage

For Claude Desktop (stdio mode)

Claude Desktop will automatically start the server when configured. Just make sure:

1. Your .env file has your OPENAI_API_KEY
2. Restart Claude Desktop after updating the config

The config uses src/stdio-server.ts which communicates via stdio.

For HTTP Mode (MCP Inspector, web clients)

Run the server in development mode with auto-reload:

npm run dev

Or in production mode:

npm run build
npm start

Connecting to MCP Clients

Claude Desktop

The server is already configured!

Setup: The configuration is at: ~/Library/Application Support/Claude/claude_desktop_config.json

It uses the compiled server and passes your API key via environment variables:

{
  "mcpServers": {
    "sora-server": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/sora-mcp/dist/stdio-server.js"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here",
        "DOWNLOAD_DIR": "/Users/yourname/Downloads/sora"
      }
    }
  }
}

See claude_desktop_config.example.json for a complete example.