Allyson

officiel

Générateur d'animations SVG alimenté par l'IA qui transforme des fichiers statiques en composants SVG animés via la plateforme Allyson

GitHub

Que pouvez-vous faire avec Allyson MCP ?

Générer un SVG animé à partir d'un fichier local — Décrivez le mouvement souhaité et fournissez les chemins source et de sortie à generate_svg_animation.
Transformer des logos statiques en composants animés — Fournissez un fichier logo et une invite comme « pulsez doucement » pour produire une version lumineuse et animée.
Créer des effets de mouvement personnalisés à partir d'images — Utilisez une invite en langage naturel pour ajouter des rebonds, des rotations, des ondulations ou d'autres animations à toute image prise en charge.

Documentation

Serveur MCP Allyson

Serveur MCP Allyson - Générateur d'animations alimenté par IA qui transforme des fichiers statiques en composants SVG animés en utilisant le Model Context Protocol (MCP).

🚀 Démarrage rapide

Installer et exécuter avec npx

npx allyson-mcp --api-key YOUR_API_KEY

🔧 Configuration

Options de ligne de commande

allyson-mcp [options]

Options:
  --api-key <key>     Your Allyson API key (required)
  --help              Show help message

Examples:
  allyson-mcp --api-key your-api-key-here
  API_KEY=your-key allyson-mcp

Variables d'environnement

Vous pouvez également définir votre clé API en tant que variable d'environnement :

export API_KEY=your-api-key-here
allyson-mcp

🎯 Fonctionnalités

Génération d'animations alimentée par IA : Transformez des images statiques en composants SVG animés
Compatible avec le protocole MCP : Fonctionne avec tout assistant IA ou outil compatible MCP
Prise en charge du téléversement de fichiers : Prend en charge divers formats d'image (PNG, JPG, SVG, etc.)
Invites d'animation personnalisées : Décrivez exactement l'animation que vous souhaitez
Traitement de fichiers locaux : Lit les fichiers depuis votre système de fichiers local
Génération automatique de sortie : Enregistre les composants animés dans les chemins spécifiés

🛠 Outils disponibles

`generate_svg_animation`

Génère un composant SVG animé à partir d'un fichier source et d'une invite d'animation.

Paramètres :

prompt (chaîne, requis) : Description de l'animation à générer
- Exemple : "Faire signe de la main au personnage"
- Exemple : "Ajouter un mouvement de rebond à la balle"
- Exemple : "Créer un effet de rotation pour le logo"
svg_path (chaîne, requis) : Chemin absolu vers le fichier source
- Exemple : "/chemin/vers/mon-icone.svg"
output_path (chaîne, requis) : Chemin absolu où enregistrer le composant animé
- Exemple : "/chemin/vers/composant-anime.tsx"

Exemple d'utilisation dans un client MCP :

{
  "tool": "generate_svg_animation",
  "arguments": {
    "prompt": "Make the logo glow and pulse gently",
    "svg_path": "/Users/john/Desktop/company-logo.svg",
    "output_path": "/Users/john/project/src/components/AnimatedLogo.tsx"
  }
}

🔌 Intégration avec les assistants IA

Ce serveur MCP est conçu pour fonctionner avec les assistants IA qui prennent en charge le Model Context Protocol, tels que :

Claude Desktop (avec configuration MCP)
Cursor IDE (avec intégration MCP)
Applications IA personnalisées (utilisant le SDK MCP)

Configuration MCP

{
  "mcpServers": {
    "allyson": {
      "command": "npx",
      "args": ["allyson-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}

📝 Exemples

Génération d'animation de base

# Start the server
allyson-mcp --api-key your-api-key

# The AI assistant can now use the tool:
# "Please animate this logo to have a subtle glow effect"
# File: /Users/john/logo.svg → /Users/john/animated-logo.tsx

🔐 Sécurité

Protection de la clé API : Votre clé API est transmise de manière sécurisée au service Allyson
Accès aux fichiers locaux : Lit uniquement les fichiers que vous spécifiez explicitement
Aucun stockage de données : Les fichiers sont traités et ne sont pas stockés sur des serveurs externes
Communication HTTPS : Toutes les communications API utilisent HTTPS sécurisé

🐛 Dépannage

Problèmes courants

Erreur « La clé API est requise »

# Solution: Provide API key via flag or environment variable
allyson-mcp --api-key YOUR_KEY
# or
export API_KEY=YOUR_KEY && allyson-mcp

Erreur « Fichier introuvable »

# Make sure to use absolute paths
❌ Wrong: ./image.svg
✅ Correct: /Users/username/project/image.svg

Erreur « Impossible de se connecter au serveur API d'animation »

Vérifiez votre connexion Internet
Vérifiez que votre clé API est valide
Assurez-vous que le service Allyson est accessible

Problèmes de permissions

# Make the file executable if needed
chmod +x node_modules/allyson-mcp/index.js

Mode débogage

Pour le débogage, vous pouvez consulter les journaux du serveur qui sont émis vers stderr :

allyson-mcp --api-key YOUR_KEY 2> debug.log

📋 Prérequis

Node.js : Version 18.0.0 ou supérieure
Clé API : Clé API Allyson valide
Connexion Internet : Requise pour la communication API

🤝 Contribution

Les contributions sont les bienvenues ! Veuillez consulter nos directives de contribution pour plus de détails.