Allyson

Allyson MCP Server

Allyson MCP Server - Trình tạo hoạt ảnh hỗ trợ AI, biến đổi các tệp tĩnh thành các thành phần SVG động bằng Giao thức Ngữ cảnh Mô hình (MCP).

🚀 Bắt đầu nhanh

Cài đặt và Chạy với npx

npx allyson-mcp --api-key YOUR_API_KEY

🔧 Cấu hình

Tùy chọn Dòng lệnh

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

Biến Môi trường

Bạn cũng có thể đặt khóa API dưới dạng biến môi trường:

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

🎯 Tính năng

• Tạo Hoạt ảnh Hỗ trợ AI: Biến đổi hình ảnh tĩnh thành các thành phần SVG động
• Tương thích Giao thức MCP: Hoạt động với mọi trợ lý AI hoặc công cụ tương thích MCP
• Hỗ trợ Tải tệp lên: Hỗ trợ nhiều định dạng hình ảnh (PNG, JPG, SVG, v.v.)
• Lời nhắc Hoạt ảnh Tùy chỉnh: Mô tả chính xác hoạt ảnh bạn muốn
• Xử lý Tệp Cục bộ: Đọc tệp từ hệ thống tệp cục bộ của bạn
• Tạo Đầu ra Tự động: Lưu các thành phần động vào đường dẫn được chỉ định

🛠 Công cụ Khả dụng

generate_svg_animation

Tạo một thành phần SVG động từ tệp nguồn và lời nhắc hoạt ảnh.

Tham số:

• prompt (chuỗi, bắt buộc): Mô tả hoạt ảnh cần tạo
  • Ví dụ: "Làm cho nhân vật vẫy tay"
  • Ví dụ: "Thêm chuyển động nảy cho quả bóng"
  • Ví dụ: "Tạo hiệu ứng xoay cho logo"
• svg_path (chuỗi, bắt buộc): Đường dẫn tuyệt đối đến tệp nguồn
  • Ví dụ: "/path/to/my-icon.svg"
• output_path (chuỗi, bắt buộc): Đường dẫn tuyệt đối nơi lưu thành phần động
  • Ví dụ: "/path/to/animated-component.tsx"

Ví dụ Sử dụng trong 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"
  }
}

🔌 Tích hợp với Trợ lý AI

Máy chủ MCP này được thiết kế để hoạt động với các trợ lý AI hỗ trợ Giao thức Ngữ cảnh Mô hình, chẳng hạn như:

• Claude Desktop (với cấu hình MCP)
• Cursor IDE (với tích hợp MCP)
• Ứng dụng AI Tùy chỉnh (sử dụng SDK MCP)

Cấu hình MCP

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

📝 Ví dụ

Tạo Hoạt ảnh Cơ bản

# 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

🔐 Bảo mật

• Bảo vệ Khóa API: Khóa API của bạn được truyền an toàn đến dịch vụ Allyson
• Truy cập Tệp Cục bộ: Chỉ đọc các tệp bạn chỉ định rõ ràng
• Không Lưu trữ Dữ liệu: Tệp được xử lý và không được lưu trữ trên máy chủ bên ngoài
• Giao tiếp HTTPS: Tất cả các giao tiếp API đều sử dụng HTTPS an toàn

🐛 Khắc phục sự cố

Các vấn đề Thường gặp

Lỗi "Yêu cầu khóa API"

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

Lỗi "Không tìm thấy tệp"

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

Lỗi "Không thể kết nối đến máy chủ API hoạt ảnh"

• Kiểm tra kết nối internet của bạn
• Xác minh khóa API của bạn hợp lệ
• Đảm bảo dịch vụ Allyson có thể truy cập được

Vấn đề về Quyền

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

Chế độ Gỡ lỗi

Để gỡ lỗi, bạn có thể kiểm tra nhật ký máy chủ được xuất ra stderr:

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

📋 Yêu cầu

• Node.js: Phiên bản 18.0.0 trở lên
• Khóa API: Khóa API Allyson hợp lệ
• Kết nối Internet: Cần thiết cho giao tiếp API

🤝 Đóng góp

Chúng tôi hoan nghênh các đóng góp! Vui lòng xem hướng dẫn đóng góp của chúng tôi để biết thêm chi tiết.

📄 Giấy phép

Giấy phép Apache-2.0 - xem tệp LICENSE để biết chi tiết.

🔗 Liên kết

• Giao thức Ngữ cảnh Mô hình
• Trang web Allyson
• Trình theo dõi Vấn đề

📞 Hỗ trợ

• Tài liệu: Kiểm tra README này và trợ giúp nội tuyến (--help)
• Vấn đề: Báo cáo lỗi trên GitHub Issues của chúng tôi