Allyson

oficial

Gerador de animação SVG com inteligência artificial que transforma arquivos estáticos em componentes SVG animados usando a plataforma Allyson

GitHub

O que você pode fazer com Allyson MCP?

Gerar SVG animado a partir de um arquivo local — Descreva o movimento desejado e forneça os caminhos de origem e saída para generate_svg_animation.
Transformar logotipos estáticos em componentes animados — Forneça um arquivo de logotipo e um prompt como "pulsar suavemente" para produzir uma versão animada e brilhante.
Criar efeitos de movimento personalizados a partir de imagens — Use um prompt em linguagem natural para adicionar animações de quicar, girar, ondular ou outras a qualquer imagem compatível.

Documentação

Allyson MCP Server

Allyson MCP Server - Gerador de animação com tecnologia de IA que transforma arquivos estáticos em componentes SVG animados usando o Model Context Protocol (MCP).

🚀 Início Rápido

Instalar e Executar com npx

npx allyson-mcp --api-key YOUR_API_KEY

🔧 Configuração

Opções de Linha de Comando

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

Variáveis de Ambiente

Você também pode definir sua chave de API como uma variável de ambiente:

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

🎯 Funcionalidades

Geração de Animação com IA: Transforme imagens estáticas em componentes SVG animados
Compatível com Protocolo MCP: Funciona com qualquer assistente de IA ou ferramenta compatível com MCP
Suporte a Upload de Arquivos: Suporta vários formatos de imagem (PNG, JPG, SVG, etc.)
Prompts de Animação Personalizados: Descreva exatamente a animação que você deseja
Processamento de Arquivos Locais: Lê arquivos do seu sistema de arquivos local
Geração Automática de Saída: Salva componentes animados nos caminhos especificados

🛠 Ferramentas Disponíveis

`generate_svg_animation`

Gera um componente SVG animado a partir de um arquivo de origem e um prompt de animação.

Parâmetros:

prompt (string, obrigatório): Descrição da animação a ser gerada
- Exemplo: "Faça o personagem acenar com a mão"
- Exemplo: "Adicione movimento de quique à bola"
- Exemplo: "Crie um efeito de rotação para o logotipo"
svg_path (string, obrigatório): Caminho absoluto para o arquivo de origem
- Exemplo: "/caminho/para/meu-icone.svg"
output_path (string, obrigatório): Caminho absoluto onde salvar o componente animado
- Exemplo: "/caminho/para/componente-animado.tsx"

Exemplo de Uso no 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"
  }
}

🔌 Integração com Assistentes de IA

Este servidor MCP foi projetado para funcionar com assistentes de IA que suportam o Model Context Protocol, como:

Claude Desktop (com configuração MCP)
Cursor IDE (com integração MCP)
Aplicações de IA Personalizadas (usando o SDK MCP)

Configuração MCP

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

📝 Exemplos

Geração Básica de Animação

# 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

🔐 Segurança

Proteção da Chave de API: Sua chave de API é transmitida de forma segura para o serviço Allyson
Acesso a Arquivos Locais: Lê apenas os arquivos que você especificar explicitamente
Sem Armazenamento de Dados: Os arquivos são processados e não são armazenados em servidores externos
Comunicação HTTPS: Todas as comunicações da API usam HTTPS seguro

🐛 Solução de Problemas

Problemas Comuns

Erro "Chave de API é obrigatória"

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

Erro "Arquivo não encontrado"

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

Erro "Não foi possível conectar ao servidor da API de animação"

Verifique sua conexão com a internet
Verifique se sua chave de API é válida
Certifique-se de que o serviço Allyson está acessível

Problemas de Permissão

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

Modo de Depuração

Para depuração, você pode verificar os logs do servidor que são enviados para stderr:

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

📋 Requisitos

Node.js: Versão 18.0.0 ou superior
Chave de API: Chave de API Allyson válida
Conexão com a Internet: Necessária para comunicação com a API

🤝 Contribuindo

Contribuições são bem-vindas! Consulte nossas diretrizes de contribuição para mais detalhes.