创意生成-mcp

Name: 创意生成-mcp
Author: TSavo

作者：TSavo15 星标更新：2025-05-26

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

项目介绍

🎬 Creatify MCP Server

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

🌟 概述

Creatify MCP Server 是一个全面的模型上下文协议（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客户端库
模型上下文协议 - 标准化的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 - 设计并创建自己的自定义角色（DIY）
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 Server？

🚀 完整的API覆盖

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

🤖 AI优先设计

✅ 自我文档化 使用how_to_use工具供AI助手使用
✅ 智能参数验证 和错误处理
✅ 视频生成过程中的实时进度更新
✅ 语义版本控制 自动发布

🎨 高级功能

✅ 高级唇同步的情感与手势控制
✅ 自定义角色创建 （DIY - 设计您自己的角色）
✅ 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角色视频

用户: "创建一个专业的角色视频，Anna说'欢迎来到我们公司！'，格式为16:9"

Claude: 我将使用Creatify MCP Server为您创建一个专业的角色视频。

[使用create_avatar_video工具：
- text: "欢迎来到我们公司！"
- avatarId: "anna_costume1_cameraA"
- aspectRatio: "16:9"
- voiceId: "en-US-AriaNeural"]

您的专业角色视频已创建！Anna以自然的唇同步和专业的表现传达了您的信息。

生成TikTok风格的短视频

用户: "制作一段关于咖啡冲泡技巧的30秒TikTok视频"

Claude: 我将为您创建一个吸引人的短格式视频，非常适合TikTok！

[使用create_ai_shorts工具：
- prompt: "快速咖啡冲泡技巧，充满活力的表现"
- aspectRatio: "9:16"
- duration: 30
- style: "energetic"]

您的TikTok准备好的短视频正在生成，具有最佳的9:16宽高比和吸引人的内容！

将网站转换为视频

用户: "将我的产品落地页转换为营销视频"

Claude: 我将把您的网站转换为一个引人入胜的营销视频。

[使用create_url_to_video工具：
- url: "https://yourproduct.com"
- aspectRatio: "16:9"
- style: "marketing"]

您的落地页已经转变为展示产品的专业营销视频！

AI驱动的脚本生成

用户: "为60秒的产品演示视频生成一个脚本"

Claude: 我将为您创建一个引人入胜的产品演示脚本。

[使用generate_ai_script工具：
- topic: "产品演示视频"
- scriptType: "commercial"
- duration: 60
- tone: "professional"]

您的脚本已准备好！它包括吸引人的钩子、清晰的价值主张以及针对60秒格式优化的强烈行动号召。

配置

设置您的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=

使用方法

与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助手现在可以使用预定义的工作流模板来处理常见的视频创建场景：

示例：产品演示工作流

用户: "使用create-product-demo提示为'神奇小工具'创建演示视频，特点为'快速、可靠、易于使用'，目标受众为小型企业主"

Claude: 我将使用产品演示工作流模板来创建一个专业的演示视频。

[Claude自动遵循完整的流程：
1. 使用generate_ai_script生成吸引人的脚本
2. 使用create_avatar_video创建角色视频
3. 优化目标受众
4. 包含明确的行动号召]

可用的提示模板：

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

📊 实时日志记录与进度

服务器提供多级严重性的结构化日志记录：

[INFO] Creatify MCP Server 初始化
[INFO] 创建角色视频 {avatarId: "anna_costume1_cameraA", aspectRatio: "16:9"}
[INFO] 等待角色视频完成...
[INFO] 角色视频已完成 {videoId: "video_abc123"}

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

🤖 AI自助系统

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

Claude: 让我检查如何使用角色视频工具...

[调用how_to_use工具，toolName: "create_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);

// 列出可用工具
const tools = await client.listTools();
console.log("可用工具:", tools.tools.map(t => t.name));

// 创建一个角色视频
const result = await client.callTool({
  name: "create_avatar_video",
  arguments: {
    text: "你好，世界！这是一段由AI生成的视频。",
    avatarId: "anna_costume1_cameraA",
    aspectRatio: "16:9",
    waitForCompletion: true
  }
});

单独运行服务器

# 设置环境变量
export CREATIFY_API_ID="your-api-id"
export CREATIFY_API_KEY="your-api-key"

# 运行服务器
creatify-mcp

AI助手示例提示

一旦配置了Claude Desktop或其他MCP客户端，您可以使用自然语言提示，例如：

"创建一个16:9比例的Anna说‘欢迎来到我们的产品演示’的视频，并等待其完成"
"将网站https://example.com转换为宣传视频"
"为‘Hello world’生成使用专业声音的文本转语音音频"
"显示所有可用的角色及其详细信息"
"检查我的剩余Creatify信用额度"
"创建两个角色之间的对话，讨论我们的新产品"

API参考

工具

`create_avatar_video`

创建带有唇同步的AI角色视频。

参数：

text (字符串，必需) - 要说的话
avatarId (字符串，必需) - 要使用的角色ID
aspectRatio ("16:9" | "9:16" | "1:1", 必需) - 视频宽高比
voiceId (字符串，可选) - 角色的声音ID
waitForCompletion (布尔值，可选) - 等待视频完成

`create_url_to_video`

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

参数：

url (字符串，必需) - 要转换的URL
visualStyle (字符串，可选) - 视觉样式模板
scriptStyle (字符串，可选) - 脚本编写样式
aspectRatio ("16:9" | "9:16" | "1:1", 可选) - 视频宽高比
waitForCompletion (布尔值，可选) - 等待视频完成

`generate_text_to_speech`

从文本生成自然语音。

参数：

text (字符串，必需) - 要转换为语音的文本
voiceId (字符串，必需) - 要使用的语音ID
waitForCompletion (布尔值，可选) - 等待音频完成

`get_video_status`

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

参数：

videoId (字符串，必需) - 要检查的视频/任务ID
videoType (字符串，必需) - 任务类型（"lipsync", "url-to-video"等）

资源

`creatify://avatars`

返回所有可用AI角色的JSON列表，包括它们的ID、名称和元数据。

`creatify://voices`

返回所有可用的文本转语音声音的JSON列表。

`creatify://templates`

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

`creatify://credits`

返回当前账户的信用余额和使用信息。

开发

# 安装依赖
npm install

# 构建项目
npm run build

# 在开发模式下运行，自动重新加载
npm run dev

# 运行测试
npm test

# 检查和格式化代码
npm run check

贡献

分叉仓库
创建功能分支 (git checkout -b feature/amazing-feature)
提交更改 (git commit -m 'Add amazing feature')
推送到分支 (git push origin feature/amazing-feature)
打开Pull Request

许可证

MIT许可证 - 详情见LICENSE文件。

📚 综合文档

🎬 视频教程

即将推出 - 展示实际使用场景的综合视频教程

📖 API参考

有关详细的API文档，请参阅：

**[Creatify API

创意生成-mcp

项目介绍

🎬 Creatify MCP Server

🌟 概述

🎨 高级MCP特性：

🎯 这使什么成为可能

🏗️ 构建于

功能

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

📚 MCP资源（6个数据源）

🏆 为什么选择Creatify MCP Server？

🚀 完整的API覆盖

🤖 AI优先设计

🎨 高级功能

💼 生产就绪

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

先决条件

安装

从npm安装（推荐）

从源码安装

🎬 实时演示示例

创建AI角色视频

生成TikTok风格的短视频

将网站转换为视频

AI驱动的脚本生成

配置

使用方法

与Claude Desktop一起使用

🎨 高级MCP特性

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

📊 实时日志记录与进度

🤖 AI自助系统

与自定义MCP客户端一起使用

单独运行服务器

AI助手示例提示

API参考

工具

create_avatar_video

create_url_to_video

generate_text_to_speech

get_video_status

资源

creatify://avatars

creatify://voices

creatify://templates

creatify://credits

开发

贡献

许可证

相关项目

📚 综合文档

🎬 视频教程

📖 API参考

`create_avatar_video`

`create_url_to_video`

`generate_text_to_speech`

`get_video_status`

`creatify://avatars`

`creatify://voices`

`creatify://templates`

`creatify://credits`