requirements.txt

# GSAP MCP Server - 系统要求和依赖
# =====================================
# 专业的GSAP动画生成MCP服务器
# 支持43个动画工具，兼容Claude Desktop

# 🚀 核心运行时要求
# ====================================

# Node.js 环境
Node.js >= 18.0.0                   # 推荐使用LTS版本 (18.19.0+)
npm >= 8.0.0                        # 包管理器
# 或者使用 yarn >= 1.22.0
# 或者使用 pnpm >= 7.0.0

# 系统兼容性
# - macOS 10.15+ (Catalina)
# - Windows 10+ (Build 1903+)
# - Linux (Ubuntu 18.04+, CentOS 8+, Debian 10+)

# 硬件要求
# - CPU: 现代多核处理器 (推荐)
# - 内存: 最少512MB RAM (推荐1GB+)
# - 存储: 最少100MB可用空间
# - 网络: 稳定互联网连接 (用于GSAP CDN)

# ====================================
# 📦 NPM 依赖包 (package.json)
# ====================================

# 核心依赖 (dependencies)
@modelcontextprotocol/sdk@^0.5.0    # MCP协议SDK - 与Claude Desktop通信
gsap@^3.12.2                        # GSAP动画库核心 - 主要动画引擎
@gsap/react@^2.1.1                  # GSAP React集成库
ua-parser-js@^1.0.37                # 用户代理解析库 - 浏览器兼容性检测
css-tree@^2.3.1                     # CSS解析库 - CSS代码生成和优化

# 开发依赖 (devDependencies)
@types/node@^20.0.0                 # Node.js TypeScript类型定义

# ====================================
# 🛠️ 安装说明
# ====================================

# 1. 环境检查
#    node --version    # 应该 >= 18.0.0
#    npm --version     # 应该 >= 8.0.0

# 2. 克隆项目
#    git clone https://github.com/Lillard01/GSAP-mcp.git
#    cd GSAP-mcp

# 3. 安装依赖
#    npm install       # 或 yarn install

# 4. 运行测试
#    npm test          # 验证功能正常

# 5. 启动服务器
#    npm start         # 或 ./start-server.sh

# 6. 配置Claude Desktop
#    编辑 Claude Desktop 的 MCP 配置文件
#    添加本项目的配置信息

# ====================================
# 🔧 开发工具推荐
# ====================================

# MCP Inspector (调试工具)
# npm install -g @modelcontextprotocol/inspector

# 代码编辑器扩展
# - VS Code: GSAP Snippets
# - VS Code: MCP Protocol Support
# - VS Code: JavaScript/TypeScript

# 浏览器开发工具
# - Chrome DevTools
# - GSAP DevTools (浏览器扩展)
# - Performance Monitor

# 代码格式化工具
# npm install -D prettier eslint

# 进程管理工具 (生产环境)
# npm install -g pm2

# ====================================
# 💰 GSAP 商业插件 (可选)
# ====================================

# ⚠️ 注意：以下插件需要 GSAP 商业许可证
# 💳 购买地址：https://greensock.com/club/
# 🆓 本项目提供免费的降级替代方案

# 文本动画插件
SplitText                           # 文本分割动画 - 1个工具需要
ScrambleTextPlugin                  # 文本扰乱效果 - 1个工具需要

# SVG动画插件
MorphSVGPlugin                      # SVG形变动画 - 1个工具需要
DrawSVGPlugin                       # SVG绘制动画 - 1个工具需要

# 物理交互插件
ThrowPropsPlugin                    # 拖拽惯性效果 - 1个工具的部分功能需要
Physics2DPlugin                     # 2D物理模拟 - 2个工具需要

# 总计：6个商业插件影响12个工具功能
# 免费可用：31个工具 (72%)
# 需要商业许可：12个工具 (28%)

# ====================================
# 🌐 浏览器兼容性 (生成代码支持)
# ====================================

# 现代浏览器 (完全支持)
Chrome >= 60                        # 推荐版本 90+
Firefox >= 55                       # 推荐版本 88+
Safari >= 12                        # 推荐版本 14+
Edge >= 79                          # 基于Chromium

# 移动浏览器
iOS Safari >= 12                   # iPhone/iPad
Android Chrome >= 60                # Android设备
Samsung Internet >= 8.0             # 三星浏览器

# 传统浏览器 (有限支持)
Internet Explorer 11                # 需要polyfill

# ====================================
# 🔒 安全要求
# ====================================

# 文件系统权限
# - 读取项目文件权限
# - 写入临时文件权限
# - 执行Node.js脚本权限

# 网络权限
# - HTTPS访问权限 (GSAP CDN)
# - 本地服务器运行权限
# - MCP协议通信权限

# Claude Desktop集成
# - 配置文件修改权限
# - 进程间通信权限

# ====================================
# ⚙️ Claude Desktop 配置
# ====================================

# 配置文件位置：
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%\Claude\claude_desktop_config.json
# Linux: ~/.config/Claude/claude_desktop_config.json

# 示例配置：
# {
#   "mcpServers": {
#     "gsap-mcp": {
#       "command": "node",
#       "args": ["/path/to/GSAP-mcp/src/index.js"],
#       "env": {}
#     }
#   }
# }

# ====================================
# 🚨 故障排除
# ====================================

# 常见问题及解决方案：

# 1. Node.js版本过低
#    错误: "SyntaxError: Unexpected token"
#    解决: 升级到Node.js 18+ LTS版本

# 2. 依赖安装失败
#    错误: "npm ERR! peer dep missing"
#    解决: npm install --legacy-peer-deps

# 3. 权限问题
#    错误: "EACCES: permission denied"
#    解决: sudo npm install (Linux/macOS)

# 4. 网络连接问题
#    错误: "ETIMEDOUT" 或 "ENOTFOUND"
#    解决: 检查防火墙，使用npm镜像源

# 5. GSAP许可证问题
#    错误: "Invalid GSAP license"
#    解决: 购买商业许可证或使用免费替代方案

# 6. Claude Desktop连接失败
#    错误: "MCP server not responding"
#    解决: 检查配置文件路径和JSON格式

# 7. 内存不足
#    错误: "JavaScript heap out of memory"
#    解决: node --max-old-space-size=4096 src/index.js

# ====================================
# 🔄 维护和更新
# ====================================

# 定期维护命令
npm update                          # 更新依赖包
npm outdated                        # 检查过时包
npm audit                           # 安全审计
npm audit fix                       # 修复安全问题

# 清理缓存
npm cache clean --force             # 清理npm缓存

# 重新安装
rm -rf node_modules package-lock.json
npm install                         # 重新安装所有依赖

# ====================================
# 📄 许可证信息
# ====================================

# 项目许可证
本项目: MIT License                 # 开源免费使用

# GSAP许可证
GSAP核心: 免费 (非商业用途)          # https://greensock.com/standard-license/
GSAP商业: 付费 (商业用途)            # https://greensock.com/licensing/
商业插件: 需要Club GreenSock会员资格  # https://greensock.com/club/

# 许可证兼容性矩阵
# 个人学习: ✅ 本项目免费 + ✅ GSAP免费
# 开源项目: ✅ 本项目免费 + ✅ GSAP免费
# 商业项目: ✅ 本项目免费 + 💰 GSAP付费

# ====================================
# 📞 支持和帮助
# ====================================

# 官方资源
# - 项目文档: README.md
# - API文档: COMPLETE_TOOLS_LIST.md
# - 问题报告: GitHub Issues
# - 功能建议: GitHub Discussions

# GSAP资源
# - 官方文档: https://greensock.com/docs/
# - 学习中心: https://greensock.com/learning/
# - 社区论坛: https://greensock.com/forums/

# MCP资源
# - 官方文档: https://modelcontextprotocol.io/
# - 开发指南: https://github.com/modelcontextprotocol/

# ====================================
# 📊 性能优化建议
# ====================================

# Node.js优化
# - 使用最新LTS版本
# - 启用V8优化: --optimize-for-size
# - 调整内存限制: --max-old-space-size=2048

# 系统优化
# - 关闭不必要的后台程序
# - 确保足够的可用内存
# - 使用SSD存储提升I/O性能

# 网络优化
# - 使用CDN加速GSAP资源
# - 配置npm镜像源 (中国用户)
# - 启用HTTP/2支持

# 最后更新: 2024年
# 版本兼容性: GSAP 3.12+, MCP SDK 0.5+, Node.js 18+