Allyson

официальный

Генератор анимированных SVG на базе ИИ, который преобразует статические файлы в анимированные SVG-компоненты с помощью платформы Allyson

GitHub
7

Что можно делать с Allyson MCP?

  • Создать анимированный SVG из локального файла — Опишите желаемое движение и укажите пути исходного и выходного файлов для generate_svg_animation.
  • Преобразовать статичные логотипы в анимированные компоненты — Предоставьте файл логотипа и подсказку, например “мягко пульсировать”, чтобы получить светящуюся анимированную версию.
  • Создавать пользовательские эффекты движения из изображений — Используйте подсказку на естественном языке, чтобы добавить подпрыгивание, вращение, волны или другие анимации к любому поддерживаемому изображению.

Документация

Allyson MCP Server

npm version Node.js Version

Allyson MCP Server — генератор анимации на базе ИИ, который преобразует статические файлы в анимированные SVG-компоненты с использованием Model Context Protocol (MCP).

Allyson Server MCP server

🚀 Быстрый старт

Install MCP Server

Установка и запуск через npx

npx allyson-mcp --api-key YOUR_API_KEY

🔧 Конфигурация

Параметры командной строки

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

Переменные окружения

Вы также можете задать свой API-ключ через переменную окружения:

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

🎯 Возможности

  • Генерация анимации на базе ИИ: Преобразование статических изображений в анимированные SVG-компоненты
  • Совместимость с MCP: Работает с любым ИИ-ассистентом или инструментом, поддерживающим MCP
  • Поддержка загрузки файлов: Поддерживает различные форматы изображений (PNG, JPG, SVG и др.)
  • Пользовательские промпты анимации: Опишите, какую именно анимацию вы хотите получить
  • Обработка локальных файлов: Читает файлы из вашей локальной файловой системы
  • Автоматическая генерация результата: Сохраняет анимированные компоненты по указанному пути

🛠 Доступные инструменты

generate_svg_animation

Генерирует анимированный SVG-компонент из исходного файла и промпта анимации.

Параметры:

  • prompt (строка, обязательно): Описание создаваемой анимации
    • Пример: "Сделай так, чтобы персонаж помахал рукой"
    • Пример: "Добавь подпрыгивающее движение мячу"
    • Пример: "Создай эффект вращения для логотипа"
  • svg_path (строка, обязательно): Абсолютный путь к исходному файлу
    • Пример: "/path/to/my-icon.svg"
  • output_path (строка, обязательно): Абсолютный путь для сохранения анимированного компонента
    • Пример: "/path/to/animated-component.tsx"

Пример использования в 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"
  }
}

🔌 Интеграция с ИИ-ассистентами

Этот MCP-сервер предназначен для работы с ИИ-ассистентами, поддерживающими Model Context Protocol, такими как:

  • Claude Desktop (с конфигурацией MCP)
  • Cursor IDE (с интеграцией MCP)
  • Пользовательские ИИ-приложения (с использованием MCP SDK)

Конфигурация MCP

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

📝 Примеры

Базовая генерация анимации

# 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

🔐 Безопасность

  • Защита API-ключа: Ваш API-ключ безопасно передается сервису Allyson
  • Доступ к локальным файлам: Читаются только те файлы, которые вы явно указываете
  • Отсутствие хранения данных: Файлы обрабатываются и не сохраняются на внешних серверах
  • HTTPS-коммуникация: Все взаимодействия с API используют безопасный протокол HTTPS

🐛 Устранение неполадок

Типичные проблемы

Ошибка «API key is required»

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

Ошибка «File not found»

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

Ошибка «Cannot connect to animation API server»

  • Проверьте подключение к интернету
  • Убедитесь, что ваш API-ключ действителен
  • Проверьте доступность сервиса Allyson

Проблемы с правами доступа

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

Режим отладки

Для отладки вы можете проверить логи сервера, которые выводятся в stderr:

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

📋 Требования

  • Node.js: Версия 18.0.0 или выше
  • API-ключ: Действительный API-ключ Allyson
  • Подключение к интернету: Необходимо для взаимодействия с API

🤝 Участие в разработке

Мы приветствуем ваш вклад! Подробности смотрите в нашем руководстве для контрибьюторов.

📄 Лицензия

Лицензия Apache-2.0 — подробности в файле LICENSE.

🔗 Ссылки

📞 Поддержка

  • Документация: Смотрите этот README и встроенную справку (--help)
  • Баг-репорты: Сообщайте об ошибках в нашем GitHub Issues