Allyson

oficial

Generador de animaciones SVG impulsado por IA que transforma archivos estáticos en componentes SVG animados utilizando la plataforma Allyson

GitHub

¿Qué puedes hacer con Allyson MCP?

Generar SVG animado desde un archivo local — Describe el movimiento que deseas y proporciona las rutas de origen y salida a generate_svg_animation.
Transformar logotipos estáticos en componentes animados — Proporciona un archivo de logotipo y un mensaje como “late suavemente” para producir una versión brillante y animada.
Crear efectos de movimiento personalizados a partir de imágenes — Usa un mensaje en lenguaje natural para agregar rebotes, giros, ondas u otras animaciones a cualquier imagen compatible.

Documentación

Servidor MCP Allyson

Servidor MCP Allyson - Generador de animaciones impulsado por IA que transforma archivos estáticos en componentes SVG animados utilizando el Protocolo de Contexto de Modelo (MCP).

🚀 Inicio Rápido

Instalar y Ejecutar con npx

npx allyson-mcp --api-key YOUR_API_KEY

🔧 Configuración

Opciones de Línea de Comandos

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 de Entorno

También puedes establecer tu clave API como una variable de entorno:

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

🎯 Características

Generación de Animaciones Impulsada por IA: Transforma imágenes estáticas en componentes SVG animados
Compatible con el Protocolo MCP: Funciona con cualquier asistente de IA o herramienta compatible con MCP
Soporte para Carga de Archivos: Soporta varios formatos de imagen (PNG, JPG, SVG, etc.)
Indicaciones de Animación Personalizadas: Describe exactamente la animación que deseas
Procesamiento de Archivos Locales: Lee archivos de tu sistema de archivos local
Generación Automática de Salida: Guarda los componentes animados en las rutas especificadas

🛠 Herramientas Disponibles

`generate_svg_animation`

Genera un componente SVG animado a partir de un archivo de origen y una indicación de animación.

Parámetros:

prompt (string, requerido): Descripción de la animación a generar
- Ejemplo: "Haz que el personaje salude con la mano"
- Ejemplo: "Añade un movimiento de rebote a la pelota"
- Ejemplo: "Crea un efecto de giro para el logotipo"
svg_path (string, requerido): Ruta absoluta al archivo de origen
- Ejemplo: "/ruta/a/mi-icono.svg"
output_path (string, requerido): Ruta absoluta donde guardar el componente animado
- Ejemplo: "/ruta/a/componente-animado.tsx"

Ejemplo de Uso en Cliente 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"
  }
}

🔌 Integración con Asistentes de IA

Este servidor MCP está diseñado para funcionar con asistentes de IA que soportan el Protocolo de Contexto de Modelo, tales como:

Claude Desktop (con configuración MCP)
Cursor IDE (con integración MCP)
Aplicaciones de IA Personalizadas (usando el SDK de MCP)

Configuración MCP

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

📝 Ejemplos

Generación Básica de Animación

# 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

🔐 Seguridad

Protección de Clave API: Tu clave API se transmite de forma segura al servicio Allyson
Acceso a Archivos Locales: Solo lee los archivos que especifiques explícitamente
Sin Almacenamiento de Datos: Los archivos se procesan y no se almacenan en servidores externos
Comunicación HTTPS: Todas las comunicaciones API utilizan HTTPS seguro

🐛 Solución de Problemas

Problemas Comunes

Error "Se requiere clave API"

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

Error "Archivo no encontrado"

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

Error "No se puede conectar con el servidor de la API de animación"

Verifica tu conexión a internet
Comprueba que tu clave API sea válida
Asegúrate de que el servicio Allyson esté accesible

Problemas de Permisos

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

Modo de Depuración

Para depuración, puedes revisar los registros del servidor que se emiten a stderr:

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

📋 Requisitos

Node.js: Versión 18.0.0 o superior
Clave API: Clave API válida de Allyson
Conexión a Internet: Requerida para la comunicación con la API

🤝 Contribuciones

¡Agradecemos las contribuciones! Por favor, consulta nuestras guías de contribución para más detalles.