Allyson

Allyson MCP Server

Allyson MCP Server - เครื่องมือสร้างภาพเคลื่อนไหวที่ขับเคลื่อนด้วย AI ซึ่งแปลงไฟล์สแตติกให้เป็นคอมโพเนนต์ SVG แบบเคลื่อนไหวโดยใช้ Model Context Protocol (MCP)

🚀 เริ่มต้นอย่างรวดเร็ว

ติดตั้งและรันด้วย 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 key ของคุณเป็นตัวแปรสภาพแวดล้อมได้:

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

🎯 คุณสมบัติ

• การสร้างภาพเคลื่อนไหวที่ขับเคลื่อนด้วย AI: แปลงภาพสแตติกให้เป็นคอมโพเนนต์ SVG แบบเคลื่อนไหว
• เข้ากันได้กับ MCP Protocol: ทำงานร่วมกับผู้ช่วยหรือเครื่องมือ AI ที่เข้ากันได้กับ MCP
• รองรับการอัปโหลดไฟล์: รองรับรูปแบบภาพที่หลากหลาย (PNG, JPG, SVG ฯลฯ)
• พรอมต์ภาพเคลื่อนไหวแบบกำหนดเอง: อธิบายภาพเคลื่อนไหวที่คุณต้องการได้อย่างแม่นยำ
• การประมวลผลไฟล์ในเครื่อง: อ่านไฟล์จากระบบไฟล์ในเครื่องของคุณ
• การสร้างผลลัพธ์อัตโนมัติ: บันทึกคอมโพเนนต์แบบเคลื่อนไหวไปยังเส้นทางที่ระบุ

🛠 เครื่องมือที่พร้อมใช้งาน

generate_svg_animation

สร้างคอมโพเนนต์ SVG แบบเคลื่อนไหวจากไฟล์ต้นฉบับและพรอมต์ภาพเคลื่อนไหว

พารามิเตอร์:

• prompt (สตริง, จำเป็น): คำอธิบายของภาพเคลื่อนไหวที่จะสร้าง
  • ตัวอย่าง: "ทำให้ตัวละครโบกมือ"
  • ตัวอย่าง: "เพิ่มการเคลื่อนไหวแบบเด้งให้กับลูกบอล"
  • ตัวอย่าง: "สร้างเอฟเฟกต์การหมุนสำหรับโลโก้"
• svg_path (สตริง, จำเป็น): เส้นทางสัมบูรณ์ไปยังไฟล์ต้นฉบับ
  • ตัวอย่าง: "/path/to/my-icon.svg"
• output_path (สตริง, จำเป็น): เส้นทางสัมบูรณ์ที่จะบันทึกคอมโพเนนต์แบบเคลื่อนไหว
  • ตัวอย่าง: "/path/to/animated-component.tsx"

ตัวอย่างการใช้งานใน 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"
  }
}

🔌 การผสานรวมกับผู้ช่วย AI

MCP server นี้ออกแบบมาเพื่อทำงานร่วมกับผู้ช่วย AI ที่รองรับ Model Context Protocol เช่น:

• 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 Key: API key ของคุณถูกส่งอย่างปลอดภัยไปยังบริการ 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 key ของคุณถูกต้อง
• ตรวจสอบให้แน่ใจว่าบริการ 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 Key: API key ของ Allyson ที่ถูกต้อง
• การเชื่อมต่ออินเทอร์เน็ต: จำเป็นสำหรับการสื่อสาร API

🤝 การมีส่วนร่วม

เรายินดีต้อนรับการมีส่วนร่วม! โปรดดูแนวทางการมีส่วนร่วมของเราสำหรับรายละเอียดเพิ่มเติม

📄 ใบอนุญาต

Apache-2.0 License - ดูไฟล์ LICENSE สำหรับรายละเอียด

🔗 ลิงก์

• Model Context Protocol
• เว็บไซต์ Allyson
• ตัวติดตามปัญหา

📞 การสนับสนุน

• เอกสารประกอบ: ตรวจสอบ README นี้และความช่วยเหลือในบรรทัด (--help)
• ปัญหา: รายงานข้อบกพร่องบน GitHub Issues ของเรา