> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Sora MCP Integrationsanleitung

> sora MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) 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 XHuoAPI 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 XHuoAPI API Token erhalten:

1. Registriere dich oder melde dich bei der [XHuoAPI Plattform](https://api.xhuoapi.ai) an
2. Gehe zur Seite [Sora Videos API](https://api.xhuoapi.ai/documents/sora-videos)
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)

```bash theme={null}
pip install mcp-sora
```

### Methode 2: Quellcode-Installation

```bash theme={null}
git clone https://github.com/XHuoAPI/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:

```json theme={null}
{
  "mcpServers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "XHuoAPI_API_TOKEN": "dein API Token"
      }
    }
  }
}
```

Wenn du `uvx` verwendest (keine vorherige Installation erforderlich):

```json theme={null}
{
  "mcpServers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "XHuoAPI_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`:

```json theme={null}
{
  "servers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "XHuoAPI_API_TOKEN": "dein API Token"
      }
    }
  }
}
```

Oder verwende `uvx`:

```json theme={null}
{
  "servers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "XHuoAPI_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: [XHuoAPI/SoraMCP](https://github.com/XHuoAPI/SoraMCP)
* PyPI Paket: [mcp-sora](https://pypi.org/project/mcp-sora/)
* API Dokumentation: [Sora Video Generierungs API](https://api.xhuoapi.ai/documents/sora)