Allyson MCP Server

resmi

Statik dosyaları Allyson platformunu kullanarak animasyonlu SVG bileşenlerine dönüştüren yapay zeka destekli SVG animasyon oluşturucu

GitHub
7

Dokümantasyon

Allyson MCP Sunucusu

npm version Node.js Version

Allyson MCP Sunucusu - Model Context Protocol (MCP) kullanarak statik dosyaları animasyonlu SVG bileşenlerine dönüştüren yapay zeka destekli animasyon üreteci.

Allyson Server MCP server

🚀 Hızlı Başlangıç

Install MCP Server

npx ile Kurulum ve Çalıştırma

npx allyson-mcp --api-key YOUR_API_KEY

🔧 Yapılandırma

Komut Satırı Seçenekleri

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

Ortam Değişkenleri

API anahtarınızı bir ortam değişkeni olarak da ayarlayabilirsiniz:

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

🎯 Özellikler

  • Yapay Zeka Destekli Animasyon Üretimi: Statik görüntüleri animasyonlu SVG bileşenlerine dönüştürün
  • MCP Protokolü Uyumlu: Herhangi bir MCP uyumlu yapay zeka asistanı veya aracıyla çalışır
  • Dosya Yükleme Desteği: Çeşitli görüntü formatlarını destekler (PNG, JPG, SVG, vb.)
  • Özel Animasyon İstemleri: İstediğiniz animasyonu tam olarak tanımlayın
  • Yerel Dosya İşleme: Yerel dosya sisteminizden dosyaları okur
  • Otomatik Çıktı Üretimi: Animasyonlu bileşenleri belirtilen yollara kaydeder

🛠 Mevcut Araçlar

generate_svg_animation

Bir kaynak dosyadan ve animasyon isteminden animasyonlu bir SVG bileşeni üretir.

Parametreler:

  • prompt (dize, zorunlu): Üretilecek animasyonun açıklaması
    • Örnek: "Karakterin elini sallamasını sağla"
    • Örnek: "Topa zıplama hareketi ekle"
    • Örnek: "Logo için döndürme efekti oluştur"
  • svg_path (dize, zorunlu): Kaynak dosyanın mutlak yolu
    • Örnek: "/path/to/my-icon.svg"
  • output_path (dize, zorunlu): Animasyonlu bileşenin kaydedileceği mutlak yol
    • Örnek: "/path/to/animated-component.tsx"

MCP İstemcisinde Örnek Kullanım:

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

🔌 Yapay Zeka Asistanlarıyla Entegrasyon

Bu MCP sunucusu, Model Context Protocol'ü destekleyen yapay zeka asistanlarıyla çalışmak üzere tasarlanmıştır, örneğin:

  • Claude Desktop (MCP yapılandırmasıyla)
  • Cursor IDE (MCP entegrasyonuyla)
  • Özel Yapay Zeka Uygulamaları (MCP SDK kullanarak)

MCP Yapılandırması

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

📝 Örnekler

Temel Animasyon Üretimi

# 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

🔐 Güvenlik

  • API Anahtarı Koruması: API anahtarınız Allyson hizmetine güvenli bir şekilde iletilir
  • Yerel Dosya Erişimi: Yalnızca açıkça belirttiğiniz dosyaları okur
  • Veri Depolama Yok: Dosyalar işlenir ve harici sunucularda saklanmaz
  • HTTPS İletişimi: Tüm API iletişimleri güvenli HTTPS kullanır

🐛 Sorun Giderme

Yaygın Sorunlar

"API anahtarı zorunludur" Hatası

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

"Dosya bulunamadı" Hatası

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

"Animasyon API sunucusuna bağlanılamıyor" Hatası

  • İnternet bağlantınızı kontrol edin
  • API anahtarınızın geçerli olduğunu doğrulayın
  • Allyson hizmetinin erişilebilir olduğundan emin olun

İzin Sorunları

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

Hata Ayıklama Modu

Hata ayıklama için, stderr'e çıktı olarak verilen sunucu günlüklerini kontrol edebilirsiniz:

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

📋 Gereksinimler

  • Node.js: Sürüm 18.0.0 veya daha yüksek
  • API Anahtarı: Geçerli bir Allyson API anahtarı
  • İnternet Bağlantısı: API iletişimi için gereklidir

🤝 Katkıda Bulunma

Katkılarınızı memnuniyetle karşılıyoruz! Daha fazla ayrıntı için katkıda bulunma yönergelerimize bakın.

📄 Lisans

Apache-2.0 Lisansı - ayrıntılar için LICENSE dosyasına bakın.

🔗 Bağlantılar

📞 Destek

  • Dokümantasyon: Bu README dosyasını ve satır içi yardımı kontrol edin (--help)
  • Sorunlar: Hataları GitHub Issues üzerinden bildirin