OpenAI의 Sora 2 API와 통합되어 비디오 생성 및 리믹스를 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다.

특징

• 동영상 만들기: Sora 2를 사용해 텍스트 프롬프트에서 동영상을 생성
• 리믹스 비디오: 기존 비디오의 변형을 새로운 프롬프트로 만듭니다
• 비디오 상태: 비디오 생성 작업의 상태 및 진행 상황 확인

선수 조건

• Node.js 18+
• Sora 접근 권한이 있는 OpenAI API 키
• MCP 호환 클라이언트(Claude, 커서, VS 코드 등)

설치

1. 저장소 복제:

2. 의존성 설치:

3. 프로젝트 구축:

4. Claude 데스크탑 설정 완료:

• claude_desktop_config.example.json를 [[T1]로 복사합니다.
• args 경로를 설치 디렉터리와 일치하도록 업데이트합니다
• OpenAI API 키를 OPENAI_API_KEY 필드에 추가하세요
• 선택적으로 DOWNLOAD_DIR를 원하는 다운로드 폴더로 설정하세요

서버 아키텍처

이 프로젝트에는 서로 다른 사용 사례를 위한 두 가지 서버 구현이 포함되어 있습니다:

📱 stdio-server.ts - 클로드 데스크톱을 위해

• 전송: 표준 입출력 (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.