Zum Hauptinhalt springen
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:
  1. Registriere dich oder melde dich bei der AceData Cloud Plattform an
  2. Gehe zur Seite Sora Videos API
  3. 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/MCPSora.git
cd MCPSora
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

WerkzeugnameBeschreibung
sora_generate_videoVideos aus Textaufforderungen generieren
sora_generate_video_from_imageVideos basierend auf Bildern erstellen
sora_generate_video_with_characterKonsistenzvideos mit Referenzcharakteren erstellen
sora_generate_video_asyncAsynchrone Einreichung von Videoerstellungsaufgaben
sora_get_taskAbfrage des Status einer einzelnen Aufgabe
sora_get_tasks_batchBatchabfrage 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