艾莉森-MCP

Name: 艾莉森-MCP
Author: isaiahbjork

作者：isaiahbjork3 星标更新：2025-06-19

安装使用来源：spider==github.com

项目介绍

Allyson MCP Server

Allyson MCP Server - 使用模型上下文协议（MCP）将静态文件转换为动画SVG组件的人工智能驱动动画生成器。

🚀 快速开始

使用 npx 安装并运行

npx allyson-mcp --api-key YOUR_API_KEY

🔧 配置

命令行选项

allyson-mcp [options]

选项:
  --api-key <key>     您的 Allyson API 密钥（必需）
  --help              显示帮助信息

示例:
  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 的人工智能助手或工具一起工作
支持文件上传：支持各种图像格式（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": "让标志发光并轻微脉动",
    "svg_path": "/Users/john/Desktop/company-logo.svg",
    "output_path": "/Users/john/project/src/components/AnimatedLogo.tsx"
  }
}

🔌 与人工智能助手集成

此 MCP 服务器旨在与支持模型上下文协议的 AI 助手一起工作，例如：

Claude Desktop（带有 MCP 配置）
Cursor IDE（带有 MCP 集成）
自定义 AI 应用程序（使用 MCP SDK）

MCP 配置

{
  "mcpServers": {
    "allyson": {
      "command": "npx",
      "args": ["allyson-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}

📝 示例

基本动画生成

# 启动服务器
allyson-mcp --api-key your-api-key

# AI 助手现在可以使用该工具：
# "请为这个标志添加微妙的发光效果"
# 文件：/Users/john/logo.svg → /Users/john/animated-logo.tsx

🔐 安全性

API 密钥保护：您的 API 密钥安全地传输到 Allyson 服务
本地文件访问：仅读取您明确指定的文件
无数据存储：文件被处理但不存储在外部服务器上
HTTPS 通信：所有 API 通信都使用安全的 HTTPS

🐛 故障排除

常见问题

“需要 API 密钥”错误

# 解决方案：通过标志或环境变量提供 API 密钥
allyson-mcp --api-key YOUR_KEY
# 或
export API_KEY=YOUR_KEY && allyson-mcp

“文件未找到”错误

# 确保使用绝对路径
❌ 错误：./image.svg
✅ 正确：/Users/username/project/image.svg

“无法连接到动画 API 服务器”错误

检查您的互联网连接
验证您的 API 密钥是否有效
确保 Allyson 服务可访问

权限问题

# 如果需要，请将文件设为可执行
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 通信

🤝 贡献

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