> ## 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.

# Seedance MCP Integrationsanleitung

> seedance MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) ist ein von Anthropic entwickeltes Modellkontextprotokoll, das es KI-Modellen (wie Claude, GPT usw.) ermöglicht, externe Tools über standardisierte Schnittstellen aufzurufen. Mit dem von XHuoAPI bereitgestellten Seedance MCP Server können Sie in AI-Clients wie Claude Desktop, VS Code, Cursor direkt die von ByteDance Seedance erzeugten AI-Videos nutzen.

## Funktionsübersicht

Der Seedance MCP Server bietet folgende Kernfunktionen:

* **Text-zu-Video** — Erzeugung hochwertiger Videos anhand von Texteingaben
* **Bild-zu-Video** — Videoerzeugung mit Bildreferenzen (Erstes Bild, letztes Bild, Referenzbild usw.)
* **Multi-Modell-Unterstützung** — Unterstützung verschiedener Modelle wie Seedance 1.5 Pro, 1.0 Pro, 1.0 Lite usw.
* **Verschiedene Auflösungen** — Unterstützung von 480p, 720p, 1080p und weiteren Auflösungen
* **Verschiedene Bildformate** — Unterstützung von Seitenverhältnissen 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 usw.
* **Flexible Videolänge** — Unterstützung von 2 bis 12 Sekunden Videolänge
* **Audioerzeugung** — Einige Modelle unterstützen die gleichzeitige Audioerzeugung
* **Aufgabenabfrage** — Überwachung des Erstellungsfortschritts und Abruf der Ergebnisse

## Voraussetzungen

Vor der Nutzung benötigen Sie einen XHuoAPI API Token:

1. Registrieren oder anmelden auf der [XHuoAPI Plattform](https://api.xhuoapi.ai)
2. Navigieren zur [Seedance Videos API](https://api.xhuoapi.ai/documents/seedance-videos) Seite
3. Klicken Sie auf „Acquire“, um den API Token zu erhalten (bei der ersten Beantragung gibt es ein kostenloses Kontingent)

## Installation und Konfiguration

### Methode 1: Installation via pip (empfohlen)

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

### Methode 2: Installation aus dem Quellcode

```bash theme={null}
git clone https://github.com/XHuoAPI/SeedanceMCP.git
cd SeedanceMCP
pip install -e .
```

Nach der Installation können Sie den Dienst mit dem Befehl `mcp-seedance` starten.

## Verwendung in Claude Desktop

Bearbeiten Sie die Konfigurationsdatei von Claude Desktop:

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

Fügen Sie folgende Konfiguration hinzu:

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

Wenn Sie `uvx` verwenden (kein vorheriges Installieren von Paketen erforderlich):

```json theme={null}
{
  "mcpServers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "XHuoAPI_API_TOKEN": "Ihr API Token"
      }
    }
  }
}
```

Speichern Sie die Konfiguration und starten Sie Claude Desktop neu, um Seedance-bezogene Tools im Chat nutzen zu können.

## Verwendung in VS Code / Cursor

Erstellen Sie im Projektstammverzeichnis die Datei `.vscode/mcp.json`:

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

Alternativ mit `uvx`:

```json theme={null}
{
  "servers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "XHuoAPI_API_TOKEN": "Ihr API Token"
      }
    }
  }
}
```

## Verfügbare Tools

| Toolname                             | Beschreibung                                               |
| ------------------------------------ | ---------------------------------------------------------- |
| `seedance_generate_video`            | Videoerzeugung anhand von Textprompt                       |
| `seedance_generate_video_from_image` | Videoerzeugung mit Bildreferenz                            |
| `seedance_get_task`                  | Abfrage des Status einer einzelnen Aufgabe                 |
| `seedance_get_tasks_batch`           | Batch-Abfrage von Aufgabenstatus                           |
| `seedance_list_models`               | Auflistung aller verfügbaren Modelle und deren Fähigkeiten |
| `seedance_list_resolutions`          | Auflistung verfügbarer Auflösungen und Bildformate         |
| `seedance_list_actions`              | Auflistung aller verfügbaren Tools und Workflow-Beispiele  |

## Anwendungsbeispiele

Nach der Konfiguration können Sie diese Funktionen direkt in Ihrem AI-Client mit natürlicher Sprache aufrufen, z. B.:

* „Erstelle mir ein Zeitraffervideo einer Stadtstraße mit Seedance“
* „Erzeuge ein 8 Sekunden langes Video mit diesem Foto als erstem Bild“
* „Erzeuge ein 1080p Hochformat-Video im Seitenverhältnis 9:16“
* „Erzeuge ein Video mit Audio mit dem Seedance 1.5 Pro Modell“

## Weitere Informationen

* GitHub Repository: [XHuoAPI/SeedanceMCP](https://github.com/XHuoAPI/SeedanceMCP)
* PyPI Paket: [mcp-seedance](https://pypi.org/project/mcp-seedance/)
* API Dokumentation: [Seedance Videoerzeugungs-API](https://api.xhuoapi.ai/documents/seedance)