Allyson

官方

AI驅動的SVG動畫生成器，可透過Allyson平台將靜態檔案轉換為動態SVG元件

GitHub

你可以用 Allyson MCP 做什麼？

從本地檔案生成動畫 SVG — 描述您想要的動畫效果，並提供來源與輸出路徑給 generate_svg_animation。
將靜態標誌轉換為動畫元件 — 提供標誌檔案與提示詞（例如「輕柔脈動」），即可產生發光且具動畫效果的版本。
從圖片建立自訂動態效果 — 使用自然語言提示詞，為任何支援的圖片加入彈跳、旋轉、擺動或其他動畫效果。

文件

Allyson MCP 伺服器

Allyson MCP 伺服器 - 採用模型上下文協定 (MCP) 的 AI 驅動動畫產生器，可將靜態檔案轉換為動態 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 通訊所需

🤝 貢獻

我們歡迎貢獻！請參閱我們的貢獻指南以獲取更多詳細資訊。