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 通信所需

🤝 贡献

我们欢迎贡献！请参阅我们的贡献指南以获取更多详细信息。