Allyson

공식

AI 기반 SVG 애니메이션 생성기로, Allyson 플랫폼을 사용하여 정적 파일을 애니메이션 SVG 컴포넌트로 변환합니다.

GitHub
7

Allyson MCP(으)로 무엇을 할 수 있나요?

  • 로컬 파일에서 애니메이션 SVG 생성 — 원하는 동작을 설명하고 generate_svg_animation에 소스 및 출력 경로를 제공하세요.
  • 정적 로고를 애니메이션 구성 요소로 변환 — 로고 파일과 "부드럽게 맥동"과 같은 프롬프트를 제공하여 빛나는 애니메이션 버전을 생성하세요.
  • 이미지에서 사용자 정의 모션 효과 만들기 — 자연어 프롬프트를 사용하여 지원되는 모든 이미지에 바운싱, 회전, 흔들기 또는 기타 애니메이션을 추가하세요.

문서

Allyson MCP 서버

npm version Node.js Version

Allyson MCP 서버 - 모델 컨텍스트 프로토콜(MCP)을 사용하여 정적 파일을 애니메이션 SVG 컴포넌트로 변환하는 AI 기반 애니메이션 생성기입니다.

Allyson Server MCP server

🚀 빠른 시작

Install MCP Server

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에서 버그 신고