Guide d’intégration Seedance MCP

seedance MCP 服务器集成

MCP (Model Context Protocol) est un protocole de contexte de modèle lancé par Anthropic, permettant aux modèles d’IA (comme Claude, GPT, etc.) d’appeler des outils externes via une interface standardisée. Grâce au Seedance MCP Server fourni par AceData Cloud, vous pouvez utiliser directement la génération de vidéos IA Seedance de ByteDance dans des clients IA tels que Claude Desktop, VS Code, Cursor, etc.

​

Aperçu des fonctionnalités

Le Seedance MCP Server offre les fonctionnalités principales suivantes :

• Génération vidéo à partir de texte — Génération de vidéos de haute qualité à partir d’invites textuelles
• Génération vidéo à partir d’images — Génération de vidéos en se basant sur des images de référence (première image, dernière image, image de référence, etc.)
• Support multi-modèles — Supporte plusieurs modèles tels que Seedance 1.5 Pro, 1.0 Pro, 1.0 Lite, etc.
• Résolutions multiples — Supporte les résolutions 480p, 720p, 1080p
• Formats d’image variés — Supporte les ratios 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, etc.
• Durée flexible — Supporte des vidéos de 2 à 12 secondes
• Génération audio — Certains modèles supportent la génération audio simultanée
• Suivi des tâches — Surveillance de la progression et récupération des résultats

​

Prérequis

Avant utilisation, vous devez obtenir un token API AceData Cloud :

1. Inscrivez-vous ou connectez-vous sur la plateforme AceData Cloud
2. Rendez-vous sur la page Seedance Videos API
3. Cliquez sur « Acquire » pour obtenir votre token API (une allocation gratuite est offerte lors de la première demande)

​

Installation et configuration

​

Méthode 1 : Installation via pip (recommandée)

pip install mcp-seedance

​

Méthode 2 : Installation depuis le code source

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

Une fois l’installation terminée, vous pouvez lancer le service avec la commande mcp-seedance.

​

Utilisation dans Claude Desktop

Modifiez le fichier de configuration de Claude Desktop :

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

Ajoutez la configuration suivante :

{
  "mcpServers": {
    "seedance": {
      "command": "mcp-seedance",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "votreTokenAPI"
      }
    }
  }
}

Si vous utilisez uvx (pas besoin d’installer les paquets à l’avance) :

{
  "mcpServers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "votreTokenAPI"
      }
    }
  }
}

Après avoir sauvegardé la configuration, redémarrez Claude Desktop pour utiliser les outils Seedance dans vos conversations.

​

Utilisation dans VS Code / Cursor

Créez un fichier .vscode/mcp.json à la racine de votre projet :

{
  "servers": {
    "seedance": {
      "command": "mcp-seedance",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "votreTokenAPI"
      }
    }
  }
}

Ou utilisez uvx :

{
  "servers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "votreTokenAPI"
      }
    }
  }
}

​

Liste des outils disponibles

Nom de l’outil	Description
seedance_generate_video	Génère une vidéo à partir d’un texte
seedance_generate_video_from_image	Génère une vidéo en se basant sur une image
seedance_get_task	Consulte l’état d’une tâche unique
seedance_get_tasks_batch	Consulte l’état de plusieurs tâches
seedance_list_models	Liste tous les modèles disponibles et leurs capacités
seedance_list_resolutions	Liste les résolutions et ratios d’image disponibles
seedance_list_actions	Liste tous les outils et exemples de workflows disponibles

​

Exemples d’utilisation

Une fois configuré, vous pouvez appeler ces fonctionnalités en langage naturel dans votre client IA, par exemple :

• « Aide-moi à générer une vidéo en time-lapse d’une rue urbaine avec Seedance »
• « Utilise cette photo comme première image pour générer une vidéo de 8 secondes »
• « Génère une courte vidéo 1080p au format portrait 9:16 »
• « Utilise le modèle Seedance 1.5 Pro pour générer une vidéo avec audio »

​

Plus d’informations

• Dépôt GitHub : AceDataCloud/MCPSeedance
• Package PyPI : mcp-seedance
• Documentation API : Seedance vidéo génération API