Allyson MCP服务器
](https://badge.fury.io/js/allyson-mcp) ](https://nodejs.org)
Allyson MCP服务器 -AI驱动的动画生成器，使用模型上下文协议（MCP）将静态文件转换为动画SVG组件。
🚀 快速开始
安装并运行npx
npx allyson-mcp --api-key YOUR_API_KEY🔧 配置
命令行选项
allyson-mcp [options]
Options:
--api-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