creatify-mcp 是 Creatify AI 的企业级 MCP（Model Context Protocol）服务器，旨在将 Creatify AI 的视频生成平台能力提供给 MCP 生态系统中的 AI 助手、聊天机器人和自动化工具。它构建在 @tsavo/creatify-api-ts TypeScript 客户端库之上，把复杂的视频创建工作流转化为简单的自然语言交互。
一、主要用途 通过该 MCP 服务器，AI 助手可以理解并执行视频生成任务。例如用户可以对 Claude Desktop 说：“创建一段 16:9 的 Anna 虚拟人视频，台词为‘欢迎来到我们的产品演示’，并等待完成”，服务器即可实际执行。它让 AI 视频生成能力更易被开发者和 AI 助手使用。
二、主要能力
- 12 个 MCP 工具：create_avatar_video（创建带嘴唇同步的 AI 虚拟人视频）、create_url_to_video（将网站转换为专业视频）、generate_text_to_speech（从文本生成自然语音）、create_multi_avatar_conversation（创建多个虚拟人对话视频）、create_custom_template_video（使用自定义模板生成视频）、create_ai_edited_video（自动编辑和增强视频）、create_ai_shorts（创建适合 TikTok、Instagram Reels 的短视频）、generate_ai_script（为视频生成 AI 脚本）、create_custom_avatar（设计并创建自定义虚拟人，即 DYOA）、manage_music（上传、管理并使用背景音乐）、create_advanced_lipsync（带情感和手势控制的高级嘴唇同步）、how_to_use（获取任意工具的详细使用信息）、get_video_status（检查视频生成任务状态）。
- 6 个 MCP 资源：creatify://avatars（可用 AI 虚拟人列表）、creatify://voices（可用语音列表）、creatify://templates（可用自定义视频模板）、creatify://music（可用背景音乐库）、creatify://credits（剩余 API 额度）、creatify://avatar/{avatarId}（特定虚拟人的详细信息）。
- 5 个工作流提示模板：create-product-demo（产品演示）、create-social-content（社交媒体内容）、create-educational-video（教育教程视频）、create-marketing-campaign（营销推广视频）、analyze-video-performance（视频分析与优化）。
- 高级 MCP 特性：可复用的视频创作模板与工作流（Prompts）、多严重级别的结构化日志（debug、info、notice、warning、error、critical、alert、emergency）、视频生成期间的实时进度跟踪、面向 AI 助手的 how_to_use 自述帮助工具、实时状态更新与进度通知。
三、使用方式 前置条件：Node.js 18 或更高版本；Creatify API 凭证（需要 Pro 计划或更高），可从 Creatify 账户设置中获取 API 凭证。 安装：推荐从 npm 安装。 配置：将 Creatify API 凭证设置为环境变量，或创建 .env 文件。 在 Claude Desktop 中：将服务器添加到 Claude Desktop 配置（macOS 路径为 ~/Library/Application Support/Claude/claude_desktop_config.json）。 也可配合自定义 MCP 客户端或作为独立服务器运行。配置完成后，可使用自然语言提示，例如：创建虚拟人视频、将网站转换为宣传视频、生成文本转语音、列出可用虚拟人、检查剩余额度、创建两个虚拟人对话视频等。
四、适用场景 适用于需要自动化视频生成的 AI 助手和自动化工具场景，包括产品演示视频、社交媒体短视频（TikTok/Instagram/YouTube）、教育教程视频、营销推广视频、视频性能分析等。
五、限制与注意事项 需要 Creatify API 凭证且账户为 Pro 计划或更高；视频创建时间通常为 2-5 分钟；API 响应时间通常小于 2 秒。安全方面建议：不要将 API 密钥提交到版本控制，使用环境变量存储敏感数据，定期轮换 API 密钥，监控 API 使用情况，所有 Webhook URL 使用 HTTPS。性能优化方面：虚拟人/语音列表可缓存 1 小时，视频状态对活跃任务每 5-10 秒轮询，模板可缓存 24 小时。项目采用 MIT 许可证。
