nuvael-mcp

Serveur MCP pour Nuvael — génère des images et vidéos IA (Sora, Veo, WAN, Kling, FLUX, Nano Banana, Seedance…) directement depuis Claude, avec ta clé Nuvael. Chaque génération débite tes crédits Nuvael.

1. Obtenir une clé API

Sur nuvael.app → Compte → API → Créer. Copie la clé nuv_live_… (elle n'est affichée qu'une fois).

2. Connecter Claude Desktop

Ajoute ceci à claude_desktop_config.json (menu Claude → Réglages → Développeur → Modifier la config), puis redémarre Claude :

{
  "mcpServers": {
    "nuvael": {
      "command": "npx",
      "args": ["-y", "nuvael-mcp"],
      "env": {
        "NUVAEL_API_KEY": "nuv_live_ta_clé",
        "NUVAEL_BASE_URL": "https://nuvael.app"
      }
    }
  }
}

Tant que le paquet n'est pas publié sur npm, remplace la commande par un lancement local :

"command": "node",
"args": ["/chemin/vers/nuvael/mcp/index.mjs"],

3. Utiliser

Dans Claude : « Génère une image de … avec Nano Banana » ou « liste les modèles Nuvael ». Claude appelle les outils ci-dessous.

Outils exposés

| Outil | Description | |---|---| | nuvael_list_models | Liste les modèles (filtre kind: image/video), coût en crédits, image requise ou non. | | nuvael_balance | Solde de crédits du compte. | | nuvael_generate | Génère une image/vidéo (model, prompt, imageUrl?, quality?, duration?). |

Variables d'environnement

| Variable | Requis | Défaut | Rôle | |---|---|---|---| | NUVAEL_API_KEY | ✅ | — | Ta clé nuv_live_…. | | NUVAEL_BASE_URL | — | https://nuvael.app | URL de l'instance Nuvael. |

API REST (sans MCP)

Le serveur MCP s'appuie sur l'API publique, utilisable depuis n'importe quel outil :

# Lister les modèles
curl https://nuvael.app/api/v1/models

# Solde
curl -H "Authorization: Bearer nuv_live_…" https://nuvael.app/api/v1/me

# Générer
curl -X POST https://nuvael.app/api/v1/generate \
  -H "Authorization: Bearer nuv_live_…" \
  -H "Content-Type: application/json" \
  -d '{"modelId":"nano-banana","prompt":"un renard origami sur une table en bois"}'