clipspeed-mcp

clipspeed-mcp

通过 Claude、ChatGPT、Cursor、Cline 或 Windsurf 创建视频并剪辑片段：生成 AI 视频（Seedance 2.5、Kling 3.0、Veo 3.1、MiniMax H3）和图片（Nano Banana Pro、GPT Image 2），打造风格一致的 AI 网红角色，将角色替换到片段中并保留其原有动作和声音（Morphaze），还可将任意视频或直播流转换为带评分和字幕、可直接发布的竖屏片段。

ClipSpeedAI 提供两种 MCP 传输方式，且它们公开的工具各不相同：

	托管（远程）	此 npm 包（本地）
传输方式	streamable-http，地址为 https://api.clipspeed.ai/mcp	stdio
身份验证	OAuth — 一键完成，无需 API 密钥	CLIPSPEED_API_KEY
安装	无需安装	npx clipspeed-mcp
AI 视频、图片、AI 网红角色、Morphaze 替换、广告创意	支持 — generate_video、generate_image、create_influencer、morphaze_swap、marketing_concept_video、estimate_cost（每次付费运行前都会显示积分消耗）	不支持
直播期间剪辑直播流	支持 — clip_livestream、check_livestream、extend_livestream、stop_livestream	不支持
将 .mp4 文件保存到磁盘	不支持	支持 — download_clip
安排帖子发布	通过 publish_to_youtube	schedule_post（支持 5 个平台）

大多数人需要托管服务——无需安装或 API 密钥，而且只有它能生成 AI 视频和图片，或剪辑仍在进行的直播流。只有在确实需要将成品文件写入本地磁盘时，才使用此 npm 包。

需要 ClipSpeedAI 付费套餐或 1 美元试用。使用 npm 包时，请前往 https://www.clipspeed.ai/dashboard/api-key/ 获取密钥——密钥格式为 csai_live_...。

请始终固定使用 [email protected]。 固定版本可避免错误发布悄悄升级你的配置。

---

安装

Claude Desktop（一条命令）

npx [email protected] install

系统会提示你输入 API 密钥，并自动将 clipspeed 服务写入 Claude Desktop 配置。你也可以直接传入密钥：

npx [email protected] install --key csai_live_your_key

然后退出并重新打开 Claude Desktop。

Claude Code

claude mcp add clipspeed -- npx -y [email protected]
export CLIPSPEED_API_KEY=csai_live_your_key

Cursor / Cline / Windsurf

将以下内容添加到 MCP 服务配置中（~/.cursor/mcp.json、Cline 的 MCP 设置或 Windsurf 的 mcp_config.json）：

{
  "mcpServers": {
    "clipspeed": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": { "CLIPSPEED_API_KEY": "csai_live_your_key" }
    }
  }
}

托管服务（无需安装或 API 密钥）— 推荐

托管服务通过 OAuth 进行身份验证，因此无需复制密钥，也无需安装任何内容：

claude mcp add --transport http clipspeed https://api.clipspeed.ai/mcp

客户端会打开浏览器一次，你批准后即可连接。在 claude.ai 或 ChatGPT 中，将其作为自定义连接器添加，并使用相同的 URL。

托管工具（10 个）：

工具	功能
submit_to_clipspeed	视频 URL → 剪辑任务。
check_clips	轮询任务 → 获取带有病毒传播评分的成品片段。
clip_livestream	连接到仍在直播的流，并在直播期间剪辑片段。
check_livestream	获取直播会话目前生成的片段。
extend_livestream	延长剪辑时间，超出原定时长。
stop_livestream	结束直播会话。
discover_trending	查找细分领域中近期增长最快的视频。
list_templates	可用的字幕／版式模板。
creator_pack	为成品片段生成标题、开场语和话题标签。
publish_to_youtube	将成品片段发布到 YouTube。

这四个直播工具仅在托管服务上提供。如果你想在 Twitch、 Kick 或 YouTube 直播期间剪辑流内容，请使用托管传输方式——npm 包无法实现。 反过来，只有 npm 包能将 .mp4 文件写入本地磁盘。

环境

变量	必需	默认值	说明
CLIPSPEED_API_KEY	是（用于提供服务）	—	你的个人 csai_live_ 密钥。
CLIPSPEED_BASE_URL	否	https://api.clipspeed.ai	用于测试时的覆盖值。

Node >= 18（使用全局 fetch）。

---

工具（npm 包 / 本地 stdio）

以下是此软件包提供的工具。有关托管服务提供的工具集（包括四个直播工具），请参阅上文的 托管服务。

工具	功能
clip_video	视频 URL → 剪辑任务（job_id）。选项：aspect_ratio、caption_style、clip_count、platform。
get_clip_status	轮询 job_id → 状态及已完成的剪辑（标题、viral_score、时长、video_url）。
list_clips	列出你近期的剪辑任务，以查找过去的 job_id。
download_clip	将 .mp4 文件保存到 ~/Downloads——下载所有剪辑，或通过 clip_index 指定一个。跳过大于 500MB 的文件。
get_usage	查看本月剩余 / 总计 / 已用积分、套餐和试用状态。
discover_trending	找出细分领域中近期增长最快的视频并进行剪辑。这是 ClipSpeedAI 的差异化特色。
schedule_post	将已完成的剪辑安排发布到 tiktok / youtube / instagram / x / linkedin。
list_scheduled_posts	查看已安排 / 已发布 / 失败的帖子。
cancel_scheduled_post	取消仍处于 scheduled 状态的帖子。
restyle_captions	为项目更换字幕样式，无需重新剪辑。

字幕样式： karaoke（默认）、hormozi、beasty、fire、youshaei、cinematic、bold。 宽高比： 9:16（默认）、1:1、16:9。

若要让 ClipSpeedAI 发布到你的社交平台，请先在 ClipSpeedAI 应用中连接各个平台（Scheduler）。schedule_post 会通过这些连接发布。

---

示例提示词

将此视频剪辑成 9:16 的短视频，添加 Hormozi 字幕，然后将评分最高的 3 个下载到我的 Downloads 文件夹：https://youtu.be/…

Claude 会运行 clip_video → 轮询 get_clip_status → 运行 download_clip → .mp4 文件会保存到 ~/Downloads。

此软件包附带一个 Claude Skill（SKILL.md）——它会引导你采用以结果为先的工作流（查找 → 剪辑 → 检查 → 下载 → 安排发布）。

---

安全

• 你的 API 密钥绝不会被记录。它只会保存在 MCP 客户端的配置文件中（或你的 shell 环境中）。
• 切勿提交或分享你的密钥。你可以随时在 https://www.clipspeed.ai/dashboard/api-key/ 轮换密钥。
• 密钥与单个账户关联，受套餐的速率限制约束，并在 ClipSpeedAI 的服务器上以哈希形式静态存储。

许可证

MIT