Allyson

resmi

Generator animasi SVG bertenaga AI yang mengubah file statis menjadi komponen SVG animasi menggunakan platform Allyson

GitHub

Apa yang bisa Anda lakukan dengan Allyson MCP?

Hasilkan SVG animasi dari file lokal — Jelaskan gerakan yang diinginkan dan berikan jalur sumber serta keluaran ke generate_svg_animation.
Ubah logo statis menjadi komponen animasi — Sediakan file logo dan perintah seperti “pulse gently” untuk menghasilkan versi bercahaya dan animasi.
Buat efek gerakan kustom dari gambar — Gunakan perintah bahasa alami untuk menambahkan animasi memantul, berputar, melambai, atau animasi lainnya ke gambar yang didukung.

Dokumentasi

Allyson MCP Server

Allyson MCP Server - Generator animasi bertenaga AI yang mengubah file statis menjadi komponen SVG animasi menggunakan Model Context Protocol (MCP).

🚀 Mulai Cepat

Instal dan Jalankan dengan npx

npx allyson-mcp --api-key YOUR_API_KEY

🔧 Konfigurasi

Opsi Baris Perintah

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

Variabel Lingkungan

Anda juga dapat mengatur kunci API sebagai variabel lingkungan:

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

🎯 Fitur

Generasi Animasi Bertenaga AI: Mengubah gambar statis menjadi komponen SVG animasi
Kompatibel dengan Protokol MCP: Bekerja dengan asisten atau alat AI apa pun yang kompatibel dengan MCP
Dukungan Unggah File: Mendukung berbagai format gambar (PNG, JPG, SVG, dll.)
Prompt Animasi Kustom: Jelaskan animasi yang Anda inginkan dengan tepat
Pemrosesan File Lokal: Membaca file dari sistem file lokal Anda
Generasi Output Otomatis: Menyimpan komponen animasi ke jalur yang ditentukan

🛠 Alat yang Tersedia

`generate_svg_animation`

Menghasilkan komponen SVG animasi dari file sumber dan prompt animasi.

Parameter:

prompt (string, wajib): Deskripsi animasi yang akan dihasilkan
- Contoh: "Buat karakter melambaikan tangan"
- Contoh: "Tambahkan gerakan memantul pada bola"
- Contoh: "Buat efek berputar untuk logo"
svg_path (string, wajib): Jalur absolut ke file sumber
- Contoh: "/path/to/my-icon.svg"
output_path (string, wajib): Jalur absolut tempat menyimpan komponen animasi
- Contoh: "/path/to/animated-component.tsx"

Contoh Penggunaan di Klien 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"
  }
}

🔌 Integrasi dengan Asisten AI

Server MCP ini dirancang untuk bekerja dengan asisten AI yang mendukung Model Context Protocol, seperti:

Claude Desktop (dengan konfigurasi MCP)
Cursor IDE (dengan integrasi MCP)
Aplikasi AI Kustom (menggunakan SDK MCP)

Konfigurasi MCP

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

📝 Contoh

Generasi Animasi Dasar

# 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

🔐 Keamanan

Perlindungan Kunci API: Kunci API Anda ditransmisikan dengan aman ke layanan Allyson
Akses File Lokal: Hanya membaca file yang Anda tentukan secara eksplisit
Tanpa Penyimpanan Data: File diproses dan tidak disimpan di server eksternal
Komunikasi HTTPS: Semua komunikasi API menggunakan HTTPS yang aman

🐛 Pemecahan Masalah

Masalah Umum

Kesalahan "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

Kesalahan "File not found"

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

Kesalahan "Cannot connect to animation API server"

Periksa koneksi internet Anda
Verifikasi bahwa kunci API Anda valid
Pastikan layanan Allyson dapat diakses

Masalah Izin

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

Mode Debug

Untuk debugging, Anda dapat memeriksa log server yang dikeluarkan ke stderr:

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

📋 Persyaratan

Node.js: Versi 18.0.0 atau lebih tinggi
Kunci API: Kunci API Allyson yang valid
Koneksi Internet: Diperlukan untuk komunikasi API

🤝 Berkontribusi

Kami menyambut kontribusi! Silakan lihat panduan kontribusi kami untuk detail lebih lanjut.