Sora MCP Integrationsanleitung

MCP (Model Context Protocol) ist ein von Anthropic eingeführtes Modellkontextprotokoll, das es KI-Modellen (wie Claude, GPT usw.) ermöglicht, externe Werkzeuge über standardisierte Schnittstellen aufzurufen. Über den von AceData Cloud bereitgestellten Sora MCP Server kannst du in AI-Clients wie Claude Desktop, VS Code, Cursor usw. direkt OpenAI Sora zur Erstellung von KI-Videos verwenden.

Funktionsübersicht

Der Sora MCP Server bietet folgende Kernfunktionen:

Textgenerierung zu Video — Hochwertige Videos aus Textaufforderungen generieren
Bildgenerierung zu Video — Videos basierend auf Bildern erstellen
Charakterkonsistenz-Video — Konsistenz der Charaktere mit Referenzbildern wahren
Asynchrone Generierung — Unterstützung für die asynchrone Einreichung von Aufgaben und Abfrage von Ergebnissen
Verschiedene Bildausrichtungen — Unterstützung für Querformat (landscape) und Hochformat (portrait)
Aufgabenabfrage — Überwachung des Generierungsfortschritts und Abruf von Ergebnissen

Vorbereitungen

Vor der Nutzung musst du ein AceData Cloud API Token erhalten:

Registriere dich oder melde dich bei der AceData Cloud Plattform an
Gehe zur Seite Sora Videos API
Klicke auf „Acquire“, um ein API Token zu erhalten (bei der ersten Anfrage wird ein kostenloses Kontingent gewährt)

Installation und Konfiguration

Methode 1: pip Installation (empfohlen)

pip install mcp-sora

Methode 2: Quellcode-Installation

git clone https://github.com/AceDataCloud/SoraMCP.git
cd SoraMCP
pip install -e .

Nach der Installation kannst du den Dienst mit dem Befehl mcp-sora starten.

Verwendung in Claude Desktop

Bearbeite die Konfigurationsdatei von Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Füge die folgende Konfiguration hinzu:

{
  "mcpServers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "dein API Token"
      }
    }
  }
}

Wenn du uvx verwendest (keine vorherige Installation erforderlich):

{
  "mcpServers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "dein API Token"
      }
    }
  }
}

Speichere die Konfiguration und starte Claude Desktop neu, um die Sora-Tools im Dialog zu verwenden.

Verwendung in VS Code / Cursor

Erstelle im Stammverzeichnis des Projekts die Datei .vscode/mcp.json:

{
  "servers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "dein API Token"
      }
    }
  }
}

Oder verwende uvx:

{
  "servers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "dein API Token"
      }
    }
  }
}

Verfügbare Werkzeugliste

Werkzeugname	Beschreibung
`sora_generate_video`	Videos aus Textaufforderungen generieren
`sora_generate_video_from_image`	Videos basierend auf Bildern erstellen
`sora_generate_video_with_character`	Konsistenzvideos mit Referenzcharakteren erstellen
`sora_generate_video_async`	Asynchrone Einreichung von Videoerstellungsaufgaben
`sora_get_task`	Abfrage des Status einer einzelnen Aufgabe
`sora_get_tasks_batch`	Batchabfrage des Status von Aufgaben

Nutzung Beispiele

Nach der Konfiguration kannst du diese Funktionen direkt in natürlicher Sprache in AI-Clients aufrufen, zum Beispiel:

„Hilf mir, mit Sora ein Video von einer Katze, die über eine Wiese läuft, zu erstellen“
„Erstelle ein Video aus diesem Personenfoto und halte die Charakterkonsistenz“
„Generiere ein Hochformat-Video mit dem Inhalt eines Sonnenaufgangs in der Stadt“
„Generiere asynchron ein Video und frage später nach dem Ergebnis“

Weitere Informationen

GitHub Repository: AceDataCloud/SoraMCP
PyPI Paket: mcp-sora
API Dokumentation: Sora Video Generierungs API

​Funktionsübersicht

​Vorbereitungen

​Installation und Konfiguration

​Methode 1: pip Installation (empfohlen)

​Methode 2: Quellcode-Installation

​Verwendung in Claude Desktop

​Verwendung in VS Code / Cursor

​Verfügbare Werkzeugliste

​Nutzung Beispiele

​Weitere Informationen