Allyson

offiziell

KI-gestützter SVG-Animation-Generator, der statische Dateien mithilfe der Allyson-Plattform in animierte SVG-Komponenten umwandelt

GitHub

Was kann man mit Allyson MCP machen?

Animiertes SVG aus einer lokalen Datei erzeugen — Beschreiben Sie die gewünschte Bewegung und geben Sie Quell- und Ausgabepfade für generate_svg_animation an.
Statische Logos in animierte Komponenten umwandeln — Geben Sie eine Logodatei und eine Eingabeaufforderung wie „sanft pulsieren“ an, um eine leuchtende, animierte Version zu erstellen.
Benutzerdefinierte Bewegungseffekte aus Bildern erstellen — Verwenden Sie eine Eingabeaufforderung in natürlicher Sprache, um Hüpfen, Drehen, Winken oder andere Animationen zu jedem unterstützten Bild hinzuzufügen.

Dokumentation

Allyson MCP Server

Allyson MCP Server – KI-gestützter Animationsgenerator, der statische Dateien mithilfe des Model Context Protocol (MCP) in animierte SVG-Komponenten umwandelt.

🚀 Schnellstart

Installation und Ausführung mit npx

npx allyson-mcp --api-key YOUR_API_KEY

🔧 Konfiguration

Befehlszeilenoptionen

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

Umgebungsvariablen

Sie können Ihren API-Schlüssel auch als Umgebungsvariable setzen:

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

🎯 Funktionen

KI-gestützte Animationserzeugung: Verwandelt statische Bilder in animierte SVG-Komponenten
MCP-Protokoll-kompatibel: Funktioniert mit jedem MCP-kompatiblen KI-Assistenten oder Werkzeug
Datei-Upload-Unterstützung: Unterstützt verschiedene Bildformate (PNG, JPG, SVG usw.)
Individuelle Animationsaufforderungen: Beschreiben Sie genau, welche Animation Sie wünschen
Lokale Dateiverarbeitung: Liest Dateien aus Ihrem lokalen Dateisystem
Automatische Ausgabegenerierung: Speichert animierte Komponenten unter angegebenen Pfaden

🛠 Verfügbare Werkzeuge

`generate_svg_animation`

Erzeugt eine animierte SVG-Komponente aus einer Quelldatei und einer Animationsaufforderung.

Parameter:

prompt (Zeichenkette, erforderlich): Beschreibung der zu erzeugenden Animation
- Beispiel: „Lass die Figur mit der Hand winken“
- Beispiel: „Füge dem Ball eine hüpfende Bewegung hinzu“
- Beispiel: „Erstelle einen Dreheffekt für das Logo“
svg_path (Zeichenkette, erforderlich): Absoluter Pfad zur Quelldatei
- Beispiel: „/pfad/zu/mein-icon.svg“
output_path (Zeichenkette, erforderlich): Absoluter Pfad, unter dem die animierte Komponente gespeichert werden soll
- Beispiel: „/pfad/zu/animated-component.tsx“

Beispielverwendung im MCP-Client:

{
  "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"
  }
}

🔌 Integration mit KI-Assistenten

Dieser MCP-Server ist für die Zusammenarbeit mit KI-Assistenten konzipiert, die das Model Context Protocol unterstützen, wie zum Beispiel:

Claude Desktop (mit MCP-Konfiguration)
Cursor IDE (mit MCP-Integration)
Individuelle KI-Anwendungen (mit MCP SDK)

MCP-Konfiguration

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

📝 Beispiele

Grundlegende Animationserzeugung

# 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

🔐 Sicherheit

API-Schlüssel-Schutz: Ihr API-Schlüssel wird sicher an den Allyson-Dienst übertragen
Lokaler Dateizugriff: Liest nur Dateien, die Sie ausdrücklich angeben
Keine Datenspeicherung: Dateien werden verarbeitet und nicht auf externen Servern gespeichert
HTTPS-Kommunikation: Die gesamte API-Kommunikation erfolgt über sicheres HTTPS

🐛 Fehlerbehebung

Häufige Probleme

Fehler „API-Schlüssel ist erforderlich“

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

Fehler „Datei nicht gefunden“

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

Fehler „Keine Verbindung zum Animations-API-Server möglich“

Überprüfen Sie Ihre Internetverbindung
Stellen Sie sicher, dass Ihr API-Schlüssel gültig ist
Stellen Sie sicher, dass der Allyson-Dienst erreichbar ist

Berechtigungsprobleme

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

Debug-Modus

Zur Fehlersuche können Sie die Serverprotokolle überprüfen, die auf stderr ausgegeben werden:

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

📋 Voraussetzungen

Node.js: Version 18.0.0 oder höher
API-Schlüssel: Gültiger Allyson-API-Schlüssel
Internetverbindung: Erforderlich für die API-Kommunikation

🤝 Mitwirken

Beiträge sind willkommen! Bitte lesen Sie unsere Mitwirkungsrichtlinien für weitere Details.