AI导哈

SVG动画生成器

Allyson MCP Server是一款基于AI的动画生成工具，能够将静态文件转换为动态SVG组件，适用于前端开发和设计场景。

  • by isaiahbjork
  • JavaScript
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 isaiahbjork/allyson-mcp

使用说明

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

🎯 特性

  • 人工智能驱动的动画生成：将静态图像转换为动画SVG组件
  • MCP协议兼容：可与任何兼容MCP的AI助手或工具配合使用
  • 文件上传支持：支持各种图像格式（PNG、JPG、SVG等）
  • 自定义动画提示：准确描述你想要什么动画
  • 本地文件处理：从本地文件系统读取文件
  • 自动输出生成：将动画组件保存到指定路径

🛠 可用工具

generate_svg_animation

从源文件和动画提示生成动画SVG组件。

参数：

  • prompt （string，必填）：要生成的动画的描述
    • 示例：“让角色挥手”
    • 示例：“为球添加弹跳动作”
    • 示例：“为徽标创建旋转效果”
  • svg_path （string，必填）：源文件的绝对路径
    • 示例：“/path/to/my icon.svg”
  • output_path （string，必填）：保存动画组件的绝对路径
    • 示例：“/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助手配合使用，例如：

  • 克劳德桌面 （带MCP配置）
  • 光标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密钥
  • Internet连接：API通信所需

🤝 贡献

我们欢迎捐款！请参阅我们的投稿指南以了解更多详细信息。

📄 许可证

Apache-2.0许可证-有关详细信息，请参阅License文件。

🔗 链接

📞 支持

  • 文档：查看此README和内联帮助(--help)
  • 问题：报告我们的bug GitHub问题

相关 MCP