clipmaster-mcp

clipmaster-mcp

mcp-name: io.github.n0Sp00n/clipmaster-mcp

面向 ClipMaster 的 MCP（Model Context Protocol）服务 — 在 clipmaster.app 提供 AI 视频剪辑。它将 ClipMaster 公共 API 封装为工具，因此 Claude Desktop、Claude Code 和任何 MCP 客户端都可以导入视频、监控处理进度、浏览片段、触发导出并安排发布。

• 仅调用公共 REST API（https://api.clipmaster.app/api/v1），并使用用户的 API 密钥 — 不访问数据库或内部服务。
• 按设计仅支持通过 URL 导入（通过 LLM 工具调用传输本地文件并不实用）。不包含账户管理（密钥、账单、OAuth 连接）；API 也会拒绝通过密钥认证访问这些路由。

要求

• Python 3.10+
• ClipMaster API 密钥（付费计划）：Web 应用 → 设置 → API 访问

安装

从此仓库检出目录运行：

pipx install ./clipmaster-mcp
# or, without installing:
uvx --from ./clipmaster-mcp clipmaster-mcp

配置

环境变量	必需	含义
CLIPMASTER_API_KEY	是*	你的 cm_live_… API 密钥
CLIPMASTER_API_BASE	否	覆盖 API 基础 URL（默认值为 https://api.clipmaster.app/api/v1）

*也可以不使用环境变量，而将密钥放入 ~/.config/clipmaster/key — 这样密钥不会出现在客户端配置文件和 shell 历史记录中：

mkdir -p ~/.config/clipmaster && printf '%s' 'cm_live_...' > ~/.config/clipmaster/key && chmod 600 ~/.config/clipmaster/key

如果两者均已设置，则优先使用环境变量。

Claude Code

claude mcp add clipmaster -e CLIPMASTER_API_KEY=cm_live_... -- clipmaster-mcp

Claude Desktop

claude_desktop_config.json：

{
  "mcpServers": {
    "clipmaster": {
      "command": "clipmaster-mcp",
      "env": { "CLIPMASTER_API_KEY": "cm_live_..." }
    }
  }
}

工具

工具	功能
ingest_youtube(url, orientation?, user_query?, compilation_format?)	导入 YouTube 视频并开始生成片段
get_status(project_id)	处理进度／状态
list_projects()	用户的项目
list_clips(project_id)	带有 AI 元数据的生成片段
get_clip(project_id, clip_id)	单个片段的完整详情
trigger_export(project_id, clip_id)	使用已保存的设置渲染片段（会扣除令牌）
get_export_status(export_id)	轮询导出状态；完成后会提供临时 download_url
list_compilations(source_project_id?) / get_compilation(id)	跨项目的片段合集
list_social_accounts()	用于安排发布的已连接渠道
schedule_post(...)	安排发布导出内容（重试时具备幂等性）
list_scheduled_posts(from_date, to_date)	指定日期范围的发布日历

开发

python3 -m venv .venv && .venv/bin/pip install -e ./clipmaster-mcp pytest
.venv/bin/pytest clipmaster-mcp/tests -q