🎬 Creatify MCP Server

🎬 Creatify MCP 服务

用于 AI 视频生成的终极 MCP 服务 —— 将 Creatify AI 强大的视频创建能力带给 MCP 生态系统中的每一位 AI 助手。

🌟 概览

Creatify MCP 服务 是一款全面的模型上下文协议（MCP）服务，可将 Creatify AI 视频生成平台的全部能力提供给 AI 助手、聊天机器人和自动化工具。该服务基于可靠的 @tsavo/creatify-api-ts TypeScript 客户端库构建，可将复杂的视频创建工作流转化为简单的自然语言交互。

🎨 高级 MCP 功能：

• 📝 提示词 - 可复用的视频创建模板和工作流
• 📊 日志记录 - 提供多个严重性级别的结构化日志记录
• 🔍 进度跟踪 - 视频生成期间实时更新
• 🤖 AI 自助 - how_to_use 工具，帮助 AI 助手了解参数
• 📊 通知 - 实时状态更新和进度通知

🎯 可以实现的功能

想象一下，你对 Claude Desktop 说：“创建一段 16:9 的头像视频，让 Anna 说‘欢迎观看我们的产品演示’，并等待视频完成”——然后它真的完成了。这就是这个 MCP 服务的强大之处。

🏗️ 构建技术

• Creatify AI API - 全球领先的 AI 视频生成平台
• @tsavo/creatify-api-ts - 功能全面的 TypeScript 客户端库
• Model Context Protocol - 标准化的 AI 助手集成
• TypeScript - 完整的类型安全和出色的开发体验

功能

🛠️ MCP 工具（12 个强大操作）

• 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 - 检查视频生成任务的状态

📚 MCP 资源（6 个数据源）

• creatify://avatars - 可用 AI 虚拟形象列表
• creatify://voices - 可用于文本转语音的语音列表
• creatify://templates - 可用的自定义视频模板
• creatify://music - 可用的背景音乐库
• creatify://credits - 剩余 API 额度
• creatify://avatar/{avatarId} - 特定虚拟形象的详细信息

🏆 为什么选择 Creatify MCP 服务？

🚀 完整的 API 覆盖

• ✅ 12 个 MCP 工具，覆盖 Creatify API 的 100% 功能
• ✅ 6 个 MCP 资源，提供全面的数据访问
• ✅ 5 个工作流提示词，适用于常见视频创作场景
• ✅ 企业级日志记录，提供 8 个严重级别

🤖 AI 优先设计

• ✅ 通过 how_to_use 工具实现自我说明，方便 AI 助手使用
• ✅ 智能参数验证和错误处理
• ✅ 视频生成期间提供实时进度更新
• ✅ 通过自动化发布实现语义化版本控制

🎨 高级功能

• ✅ 高级唇形同步中的情绪和手势控制
• ✅ 自定义虚拟形象创建（DYOA — 设计你自己的虚拟形象）
• ✅ 适用于各种视频类型的 AI 驱动脚本生成
• ✅ 针对 TikTok/Instagram/YouTube 优化的短视频
• ✅ 背景音乐管理和集成

💼 可用于生产环境

• ✅ 使用 TypeScript 确保类型安全并提供更好的 IDE 支持
• ✅ 全面的错误处理，包含详细上下文
• ✅ 用于监控和调试的专业日志记录
• ✅ 自动化测试和持续集成
• ✅ 通过语义化版本控制实现可靠更新

📝 MCP 提示词（5 个工作流模板）

• create-product-demo - 专业产品演示工作流
• create-social-content - 制作吸引人的社交媒体内容
• create-educational-video - 教育和教程视频工作流
• create-marketing-campaign - 营销活动视频创作
• analyze-video-performance - 视频表现分析与优化

前提条件

• Node.js 18 或更高版本
• Creatify API 凭据（Pro 套餐或更高版本）
  • 在 Creatify 账户设置中获取 API 凭据

安装

从 npm 安装（推荐）

npm install -g @tsavo/creatify-mcp

从源代码安装

git clone https://github.com/TSavo/creatify-mcp.git
cd creatify-mcp
npm install
npm run build
npm link

🎬 实时演示示例

创建 AI 虚拟形象视频

User: "Create a professional avatar video with Anna saying 'Welcome to our company!' in 16:9 format"

Claude: I'll create a professional avatar video for you using the Creatify MCP Server.

[Uses create_avatar_video tool with:
- text: "Welcome to our company!"
- avatarId: "anna_costume1_cameraA"
- aspectRatio: "16:9"
- voiceId: "en-US-AriaNeural"]

Your professional avatar video has been created! Anna delivers your message with natural lip-sync and professional presentation.

生成 TikTok 风格短视频

User: "Make a 30-second TikTok video about coffee brewing tips"

Claude: I'll create an engaging short-form video perfect for TikTok!

[Uses create_ai_shorts tool with:
- prompt: "Quick coffee brewing tips with energetic presentation"
- aspectRatio: "9:16"
- duration: 30
- style: "energetic"]

Your TikTok-ready short video is being generated with optimal 9:16 aspect ratio and engaging content!

将网站转换为视频

User: "Turn my product landing page into a marketing video"

Claude: I'll convert your website into a compelling marketing video.

[Uses create_url_to_video tool with:
- url: "https://yourproduct.com"
- aspectRatio: "16:9"
- style: "marketing"]

Your landing page has been transformed into a professional marketing video showcasing your product!

AI 驱动的脚本生成

User: "Generate a script for a 60-second product demo video"

Claude: I'll create a compelling script for your product demo.

[Uses generate_ai_script tool with:
- topic: "Product demonstration video"
- scriptType: "commercial"
- duration: 60
- tone: "professional"]

Your script is ready! It includes engaging hooks, clear value propositions, and a strong call-to-action optimized for 60-second format.

配置

将 Creatify API 凭据设置为环境变量：

export CREATIFY_API_ID="your-api-id"
export CREATIFY_API_KEY="your-api-key"

或者创建一个 .env 文件：

CREATIFY_API_ID=your-api-id
CREATIFY_API_KEY=your-api-key

使用方法

使用 Claude Desktop

将以下内容添加到 Claude Desktop 配置文件中（macOS 上的路径为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "creatify": {
      "command": "creatify-mcp",
      "env": {
        "CREATIFY_API_ID": "your-api-id",
        "CREATIFY_API_KEY": "your-api-key"
      }
    }
  }
}

🎨 高级 MCP 功能

📝 使用提示词（工作流模板）

AI 助手现在可以使用预定义的工作流模板来处理常见的视频创作场景：

示例：产品演示工作流

User: "Use the create-product-demo prompt for 'Amazing Widget' with features 'fast, reliable, easy to use' targeting small business owners"

Claude: I'll use the product demo workflow template to create a professional demonstration video.

[Claude automatically follows the complete workflow:
1. Generates an engaging script using generate_ai_script
2. Creates avatar video using create_avatar_video
3. Optimizes for the target audience
4. Includes clear call-to-action]

可用的提示词模板：

• create-product-demo - 专业的产品演示
• create-social-content - TikTok/Instagram/YouTube 内容
• create-educational-video - 教程和教育内容
• create-marketing-campaign - 营销和推广视频
• analyze-video-performance - 视频优化和分析

📊 实时日志记录与进度

服务提供具有多个严重级别的结构化日志记录：

[INFO] Creatify MCP Server initialized
[INFO] Creating avatar video {avatarId: "anna_costume1_cameraA", aspectRatio: "16:9"}
[INFO] Waiting for avatar video completion...
[INFO] Avatar video completed {videoId: "video_abc123"}

日志级别： debug、info、notice、warning、error、critical、alert、emergency

🤖 AI 自助系统

AI 助手现在可以使用 how_to_use 工具更好地理解工具参数：

Claude: Let me check how to use the avatar video tool...

[Calls how_to_use tool with toolName: "create_avatar_video"]

[Gets comprehensive documentation with:
- Required parameters with descriptions
- Optional parameters with usage notes
- Real code examples
- Tips and best practices]

Now I understand exactly how to create your avatar video!

使用自定义 MCP 客户端

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

const transport = new StdioClientTransport({
  command: "creatify-mcp",
  env: {
    CREATIFY_API_ID: "your-api-id",
    CREATIFY_API_KEY: "your-api-key"
  }
});

const client = new Client({
  name: "my-client",
  version: "1.0.0"
});

await client.connect(transport);

// List available tools
const tools = await client.listTools();
console.log("Available tools:", tools.tools.map(t => t.name));

// Create an avatar video
const result = await client.callTool({
  name: "create_avatar_video",
  arguments: {
    text: "Hello, world! This is an AI-generated video.",
    avatarId: "anna_costume1_cameraA",
    aspectRatio: "16:9",
    waitForCompletion: true
  }
});

独立服务

# Set environment variables
export CREATIFY_API_ID="your-api-id"
export CREATIFY_API_KEY="your-api-key"

# Run the server
creatify-mcp

AI 助手的提示词示例

配置好 Claude Desktop 或其他 MCP 客户端后，你可以使用如下自然语言提示词：

• “创建一个 16:9 的 Anna 虚拟形象视频，让她说‘欢迎观看我们的产品演示’，并等待视频完成”
• “将网站 https://example.com 转换成宣传视频”
• “使用专业音色为‘Hello world’生成文本转语音音频”
• “显示所有可用的虚拟形象及其详情”
• “查看我剩余的 Creatify 积分”
• “创建两个虚拟形象讨论我们新产品的对话”

API 参考

工具

create_avatar_video

创建带有口型同步语音的 AI 虚拟形象视频。

参数：

• text (string，必填) - 要说的文本
• avatarId (string，必填) - 要使用的虚拟形象 ID
• aspectRatio ("16:9" | "9:16" | "1:1"，必填) - 视频宽高比
• voiceId (string，可选) - 虚拟形象的音色 ID
• waitForCompletion (boolean，可选) - 等待视频完成

create_url_to_video

将网站 URL 转换成专业视频。

参数：

• url (string，必填) - 要转换的 URL
• visualStyle (string，可选) - 视觉风格模板
• scriptStyle (string，可选) - 脚本写作风格
• aspectRatio ("16:9" | "9:16" | "1:1"，可选) - 视频宽高比
• waitForCompletion (boolean，可选) - 等待视频完成

generate_text_to_speech

将文本转换成自然语音。

参数：

• text (string，必填) - 要转换成语音的文本
• voiceId (string，必填) - 要使用的音色 ID
• waitForCompletion (boolean，可选) - 等待音频完成

get_video_status

检查视频生成任务的状态。

参数：

• videoId (string，必填) - 要检查的视频/任务 ID
• videoType (string，必填) - 任务类型（"lipsync"、"url-to-video" 等）

资源

creatify://avatars

返回包含所有可用 AI 虚拟形象的 ID、名称和元数据的 JSON 列表。

creatify://voices

返回包含所有可用于文本转语音生成的音色的 JSON 列表。

creatify://templates

返回可用自定义视频模板的 JSON 列表。

creatify://credits

返回当前账户的积分余额和使用情况。

开发

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode with auto-reload
npm run dev

# Run tests
npm test

# Lint and format code
npm run check

贡献

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add amazing feature'）
4. 将分支推送到远程仓库（git push origin feature/amazing-feature）
5. 创建 Pull Request

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。

相关项目

• @tsavo/creatify-api-ts - Creatify API 的 TypeScript 客户端
• Model Context Protocol - 协议规范
• Creatify AI - AI 视频生成平台

📚 完整文档

🎬 视频教程

即将推出——展示真实使用场景的全面视频教程

📖 API 参考

详细的 API 文档请参阅：

• Creatify API Documentation - Creatify 官方 API 文档
• @tsavo/creatify-api-ts Documentation - TypeScript 客户端库文档
• Model Context Protocol Specification - MCP 协议详情

🔧 高级配置

环境变量

变量	必需	描述	示例
CREATIFY_API_ID	✅	你的 Creatify API ID	your-api-id-here
CREATIFY_API_KEY	✅	你的 Creatify API 密钥	your-api-key-here
MCP_LOG_LEVEL	❌	日志级别	debug、info、warn、error

Claude Desktop 高级配置

{
  "mcpServers": {
    "creatify": {
      "command": "creatify-mcp",
      "env": {
        "CREATIFY_API_ID": "your-api-id",
        "CREATIFY_API_KEY": "your-api-key",
        "MCP_LOG_LEVEL": "info"
      },
      "args": ["--verbose"]
    }
  }
}

🚀 性能优化

批量操作

如果要创建多个视频，可以考虑使用批处理功能：

// Example: Create multiple videos efficiently
const videos = await Promise.all([
  client.callTool({
    name: "create_avatar_video",
    arguments: { text: "Video 1", avatarId: "anna", aspectRatio: "16:9" }
  }),
  client.callTool({
    name: "create_avatar_video",
    arguments: { text: "Video 2", avatarId: "john", aspectRatio: "16:9" }
  })
]);

缓存策略

• 头像/语音列表：缓存 1 小时（它们很少变化）
• 视频状态：对于正在处理的任务，每隔 5–10 秒轮询一次
• 模板：缓存 24 小时

🔐 安全最佳实践

1. 切勿将 API 密钥提交到版本控制系统
2. 使用环境变量存储所有敏感数据
3. 定期轮换 API 密钥
4. 监控 API 使用情况，以检测未经授权的访问
5. 所有 Webhook URL 均使用 HTTPS

🐛 故障排除

常见问题

“未找到 API 凭据”

# Solution: Set environment variables
export CREATIFY_API_ID="your-api-id"
export CREATIFY_API_KEY="your-api-key"

“视频创建失败”

• 检查你的 Creatify 账户额度
• 确认头像/语音 ID 存在
• 确保文本不为空
• 检查宽高比是否有效

“MCP 连接失败”

• 确认服务正在运行
• 检查 Claude Desktop 配置
• 确保 Node.js 版本 >= 18

调试模式

# Run with debug logging
MCP_LOG_LEVEL=debug creatify-mcp

📊 监控与分析

使用情况跟踪

监控你的 Creatify API 使用情况：

// Check remaining credits
const credits = await client.readResource({ uri: "creatify://credits" });
console.log(`Remaining credits: ${JSON.parse(credits.contents[0].text).remaining_credits}`);

性能指标

• 视频创建时间：通常为 2–5 分钟
• API 响应时间：通常 < 2 秒
• 成功率：监控失败的请求

🤝 贡献

欢迎贡献！以下是开始参与的方法：

🛠️ 开发环境设置

# Clone the repository
git clone https://github.com/TSavo/creatify-mcp.git
cd creatify-mcp

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with your API credentials

# Run tests
npm test

# Build the project
npm run build

# Run in development mode
npm run dev

🧪 测试

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Run type checking
npm run type-check

# Run linting
npm run lint

📝 代码风格

我们使用：

• ESLint 进行代码检查
• Prettier 进行代码格式化
• TypeScript 确保类型安全
• Conventional Commits 编写提交消息

🔄 Pull Request 流程

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 进行修改
4. 为新功能添加测试
5. 确保所有测试均通过（npm test）
6. 运行代码检查（npm run lint:fix）
7. 提交修改（git commit -m 'feat: add amazing feature'）
8. 将分支推送到远程仓库（git push origin feature/amazing-feature）
9. 创建 Pull Request

📄 许可证

本项目采用 MIT License 许可，详情请参阅 LICENSE 文件。

🙏 致谢

• Creatify AI - 感谢提供出色的 AI 视频生成平台
• @tsavo/creatify-api-ts - 为此服务提供支持的可靠 TypeScript 客户端库
• Anthropic - 感谢 Claude 和 Model Context Protocol
• MCP Community - 感谢提供标准化协议，让此次集成成为可能

📞 支持

• 📖 Creatify API 文档 - 官方 API 文档
• 🐛 报告问题 - 错误报告和功能请求
• 💬 MCP 社区 - 社区讨论
• 📧 联系作者 - 直接获取支持

---