JustClip

justclip-mcp

在 Claude、Cursor 或任何 MCP 客户端中剪辑视频。 视频会先在你的机器上下载，然后上传到 JustClip。积分、剪辑内容和套餐都与应用中相同。

有何不同

JustClip 会在你的机器上运行 yt-dlp， 然后上传视频进行处理。这样就无需依赖数据中心连接来下载 YouTube 视频。来源平台的限制仍然适用。

此软件包是供 Claude Desktop、Claude Code、 Cursor、Codex 和其他可运行本地服务的客户端使用的本地 stdio 服务。

若要在浏览器中通过 Claude 或 ChatGPT 使用，请连接 JustClip 的托管 MCP 服务： https://justclip.ai/api/mcp。它使用 Streamable HTTP 和浏览器 OAuth。 托管版设置说明。托管版下载会返回链接；本地文件必须在控制面板中上传。YouTube 抓取受账户套餐限制；本地软件包会在你的机器上下载。

设置 — 无需复制密钥

Agent 首次剪辑内容时，会在浏览器中打开 “授权 JustClip”页面。你点击授权（你已经登录 justclip.ai），就完成了——令牌会存储在本地，你无需查看或粘贴密钥。你可以随时在设置中撤销授权。

使用 Node.js 22 或更高版本。若要下载视频，请安装 yt-dlp 和 ffmpeg： macOS 上运行 brew install yt-dlp ffmpeg，或为你的平台安装它们。 安装 yt-dlp 的其他方式包括：brew install yt-dlp、pipx install yt-dlp， 或 pip install -U yt-dlp。

选项 A — 一键安装（Claude Desktop）

下载 JustClip Desktop Extension（justclip.mcpb）：双击它， Claude Desktop 就会安装该服务，首次剪辑时会触发浏览器授权。 无需编辑任何内容。

选项 B — 配置（Cursor 或手动设置）

{
  "mcpServers": {
    "justclip": {
      "command": "npx",
      "args": ["-y", "https://github.com/0Xflacko/justclip-mcp/releases/download/v0.3.0/justclip-mcp-0.3.0.tgz"]
    }
  }
}

发布 tarball 是公开的；无需 npm 账户。

无需设置 env——授权通过浏览器流程完成。（高级用户/CI 可以设置 JUSTCLIP_API_KEY 以跳过此流程，并设置 JUSTCLIP_BASE_URL 以使用预发布环境。）

工具

工具	功能
account()	套餐、剩余积分（以及 AI 可以使用的积分）、最大上传文件、同意状态。
clip_video(source, subtitleStyle?, template?, focus?, liveFrom?)	YouTube/Twitch/Kick URL 或本地文件。视频会在你的设备上下载并上传；直播中的 Twitch/Kick 频道会实时剪辑。
list_projects(limit?)	最近的项目及其状态、时长和片段数量。
project_status(projectId)	处理状态以及已就绪的片段数量。
list_clips(projectId)	片段及其开场、评分、时长和渲染状态；标出因套餐导出上限而被锁定的片段。
download_clip(projectId, clipId, outputPath, template?, format?)	保存已渲染的片段（.mp4）或其字幕（.srt）。
download_all_clips(projectId, outputPath)	将所有可导出的片段和封面保存为一个 .zip。
stop_live(projectId)	停止观看直播流；最后一轮处理会完成片段。
more_moments(projectId, limit?)	找到但尚未制作成片段的精彩时刻，按优先级排序。
make_clip(projectId, candidateId)	将其中一个精彩时刻制作成完整片段（免费）。
rename_clip(projectId, clipId, title)	更改片段标题。
caption_variants(projectId, clipId, styleIds)	将片段复制为最多 3 种其他字幕样式（Pro、Studio）。
post_drafts(projectId, clipIds?)	为 TikTok/Shorts/Reels、X 和 LinkedIn 准备可直接发布的开场文案、说明文字和主题标签。不会发布内容。
`beat_edit(music, video?	projectId?, style?, length?, …)`
beat_edit_status(id?)	查看 Beat Edit 的进度或最近的 Beat Edit。
download_beat_edit(id, outputPath)	保存已完成的 Beat Edit。
ai_models()	AI Studio 图片和视频模型、模板、积分价格以及账户积分。
ai_ideas(clipId)	为片段提供 B-roll、开场、封面和产品镜头创意，以及提示词和价格。免费。
`ai_price(model	recipe, …)`
`ai_generate(model	recipe, clipId?, prompt?, settings?, refs?, …)`
ai_status(id)	查看排队中、运行中、已完成或失败的状态，以及预计等待时间。
ai_list(clipId?)	查看某个片段的生成内容，或账户中已完成的生成内容。
ai_cancel(id)	取消尚未开始的任务；积分会退还。
ai_download(id, outputPath)	保存已完成的图片或视频。
upload_media(path)	上传图片、歌曲或短视频，作为 AI 输入或封面。
`set_cover(clipId, generationId	key

所有功能共用同一积分余额：剪辑每分钟素材消耗 1 积分，Beat Edit 消耗 1 积分，AI 生成则按任务以积分计价；Agent 会使用 ai_price 查询价格并先征求你的同意。一次性 AI 同意（年满 18 岁、未经同意不得使用真实人物或品牌，以及肖像同意）需由你在浏览器中授予；Agent 无法代你授予。

它不会做什么

它绝不会购买任何东西。当你的积分用尽、达到套餐导出上限或没有有效套餐时，工具响应会用清晰易懂的语言说明情况，并提供一个由你打开的链接——购买始终需要由真人点击，绝不会由 Agent 操作。它也无法更改你的套餐、查看你的密码、访问其他账户、删除你的项目或片段、发布任何内容，或代你接受条款并授予同意。

示例

**你：**剪辑这个视频并给我评分最高的 3 个片段 — https://youtube.com/watch?v=…

Agent： （调用 clip_video → 浏览器打开 → 你点击 Authorize） 已在你的设备上下载并上传（自己的频道）——项目 abc123 正在处理中。（轮询 project_status，然后调用 list_clips，再调用 download_clip 下载评分最高的 3 个片段）

隐私政策

JustClip 隐私政策涵盖上传的媒体、账户数据、处理服务提供商、存储、保留和删除。本地服务器会将您选择的视频、媒体和请求发送至 JustClip。完成 JustClip 中要求的授权后，AI 生成也可能会按照该政策所述，将所选媒体发送给相关服务提供商。本地下载会连接来源平台。此服务器不会将您的聊天记录发送至 JustClip。

您的授权令牌会以文件模式 0600 保存到 ~/.justclip/token.json，并在 JustClip 基础 URL 相同时重复使用。请在 JustClip 设置中撤销该令牌。下载的文件会写入您指定的输出路径，并可能覆盖现有文件。剪辑和生成可能会消耗您现有的 JustClip 点数；此服务器无法购买点数或更改您的订阅。

支持：justclip.ai/contact · [email protected] · 报告问题

开发

npm ci
npm test
npm run bundle

npm run bundle 会将生产依赖写入 artifacts/justclip.mcpb。 服务器源代码和打包文件采用 MIT 许可；JustClip 服务的使用须遵守 JustClip 条款。

目录列表

• 官方 MCP 注册表
• Smithery
• Glama 本地服务
• Glama 托管连接器

Glama 的本地服务已通过构建和工具发现检查。其构建设置记录在 glama-build-spec.json 中；输入启动命令时，请勿包含 mcp-proxy 封装器，Glama 会自行添加。占位密钥仅用于检查架构。用户需授权自己的 JustClip 账户。托管连接器则需要维护者 OAuth 测试配置文件，以及 Glama 回调的生产环境支持。

要发布到 Smithery，请运行 npm run bundle 和 npm run smithery:metadata。使用 Smithery 发布 API，将 artifacts/justclip.mcpb 作为 bundle 提交，并将 artifacts/smithery-release.json 中的 JSON 作为 payload 提交。元数据包含 Smithery 服务卡所需的实际工具输入架构。Smithery CLI 4.11.1 会将较简单的桌面清单条目复制到该卡片中，导致验证失败；使用 API 则会保留标准 MCPB 清单。