Allyson

आधिकारिक

AI-संचालित SVG एनिमेशन जनरेटर जो Allyson प्लेटफॉर्म का उपयोग करके स्थिर फ़ाइलों को एनिमेटेड SVG घटकों में बदलता है

GitHub

Allyson MCP के साथ आप क्या कर सकते हैं?

स्थानीय फ़ाइल से एनिमेटेड SVG उत्पन्न करें — आप जो गति चाहते हैं उसका वर्णन करें और generate_svg_animation को स्रोत और आउटपुट पथ प्रदान करें।
स्थिर लोगो को एनिमेटेड घटकों में बदलें — एक लोगो फ़ाइल और "धीरे-धीरे स्पंदित करें" जैसा प्रॉम्प्ट प्रदान करें ताकि एक चमकदार, एनिमेटेड संस्करण तैयार हो।
छवियों से कस्टम गति प्रभाव बनाएं — किसी भी समर्थित छवि में उछलना, घूमना, हिलना या अन्य एनिमेशन जोड़ने के लिए प्राकृतिक-भाषा प्रॉम्प्ट का उपयोग करें।

दस्तावेज़

Allyson MCP सर्वर

Allyson MCP सर्वर - AI-संचालित एनिमेशन जनरेटर जो मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) का उपयोग करके स्थिर फ़ाइलों को एनिमेटेड SVG घटकों में बदलता है।

🚀 त्वरित शुरुआत

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

🎯 विशेषताएँ

AI-संचालित एनिमेशन जनरेशन: स्थिर छवियों को एनिमेटेड SVG घटकों में बदलें
MCP प्रोटोकॉल संगत: किसी भी MCP-संगत AI सहायक या उपकरण के साथ काम करता है
फ़ाइल अपलोड समर्थन: विभिन्न छवि प्रारूपों (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"
  }
}

🔌 AI सहायकों के साथ एकीकरण

यह MCP सर्वर उन AI सहायकों के साथ काम करने के लिए डिज़ाइन किया गया है जो मॉडल कॉन्टेक्स्ट प्रोटोकॉल का समर्थन करते हैं, जैसे:

Claude Desktop (MCP कॉन्फ़िगरेशन के साथ)
Cursor IDE (MCP एकीकरण के साथ)
कस्टम AI अनुप्रयोग (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 कुंजी आवश्यक है" त्रुटि

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

"फ़ाइल नहीं मिली" त्रुटि

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

"एनिमेशन API सर्वर से कनेक्ट नहीं हो सका" त्रुटि

अपना इंटरनेट कनेक्शन जाँचें
सत्यापित करें कि आपकी 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 कुंजी: मान्य Allyson API कुंजी
इंटरनेट कनेक्शन: API संचार के लिए आवश्यक

🤝 योगदान

हम योगदान का स्वागत करते हैं! कृपया अधिक जानकारी के लिए हमारे योगदान दिशानिर्देश देखें।

📄 लाइसेंस

Apache-2.0 लाइसेंस - विवरण के लिए LICENSE फ़ाइल देखें।

🔗 लिंक

📞 सहायता

दस्तावेज़ीकरण: यह README और इनलाइन सहायता देखें (--help)
समस्याएँ: हमारे GitHub Issues पर बग रिपोर्ट करें