Clipmaster Mcp

io.github.n0Sp00n由 GitHub 帳號 n0Sp00n 發布v0.1.1更新於 Oct 24, 2026

AI video clipping with ClipMaster (clipmaster.app): clips, exports, scheduling.

已驗證STDIO僅桌面效率與工作流媒體與設計

概覽

AI 產生的概覽

ClipMaster MCP 讓助理透過 ClipMaster API 匯入 YouTube 影片、產生 AI 剪輯、匯出並安排社群貼文。

可以做什麼
依網址匯入 YouTube 影片並啟動 AI 剪輯產生,查詢處理進度,列出專案與帶有 AI 中繼資料的剪輯,或查看單一剪輯的完整詳情。依已儲存的設定算圖剪輯,並輪詢匯出狀態直到取得暫時下載連結。瀏覽跨專案的剪輯合輯。列出已連結的社群頻道,安排匯出內容的發布,並查看指定日期範圍的發布行事曆。
適用情境
適合已在使用 ClipMaster 的人,想讓助理在對話中推動剪輯流程:啟動匯入、追蹤處理、檢視剪輯、匯出成品以及規劃排程發布。
執行需求
以 Python 套件形式透過 stdio 在本機執行,需要 Python 3.10+,可用 pipx 安裝或以 uvx 執行。需要付費方案的 ClipMaster API 金鑰,透過環境變數 CLIPMASTER_API_KEY 或使用者設定目錄下的金鑰檔提供。需要連線至 ClipMaster 公開 API 的網路存取,可用 CLIPMASTER_API_BASE 覆寫 API 位址。
安裝前請注意
API 金鑰(CLIPMASTER_API_KEY)是付費帳號的有效憑證,盡量避免寫入共用的設定檔。觸發匯出會消耗帳號中的 token,安排發布會把內容發布到已連結的社群頻道。影片匯入僅支援網址,金鑰與帳務等帳號管理功能無法使用。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Clipmaster Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

clipmaster-mcp

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

MCP (Model Context Protocol) server for ClipMaster — AI video clipping at clipmaster.app. It exposes the ClipMaster public API as tools, so Claude Desktop, Claude Code, and any MCP client can ingest videos, monitor processing, browse clips, trigger exports, and schedule posts.

  • Talks ONLY to the public REST API (https://api.clipmaster.app/api/v1) with the user's API key — no database access, no internal services.
  • Ingestion is URL-only by design (streaming a local file through an LLM tool call is impractical). Account management (keys, billing, OAuth connects) is excluded; the API rejects those routes for key auth anyway.

Requirements

  • Python 3.10+
  • A ClipMaster API key (paid plans): web app → Settings → API access

Install

From this repo checkout:

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

Configure

Env varRequiredMeaning
CLIPMASTER_API_KEYyes*Your cm_live_… API key
CLIPMASTER_API_BASEnoOverride the API base URL (default https://api.clipmaster.app/api/v1)

*Instead of the env var you can put the key in ~/.config/clipmaster/key — this keeps it out of client config files and shell history:

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

The env var wins when both are set.

Claude Code

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

Claude Desktop

claude_desktop_config.json:

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

Tools

ToolWhat it does
ingest_youtube(url, orientation?, user_query?, compilation_format?)Import a YouTube video, start clip generation
get_status(project_id)Processing progress / state
list_projects()The user's projects
list_clips(project_id)Generated clips with AI metadata
get_clip(project_id, clip_id)Full detail for one clip
trigger_export(project_id, clip_id)Render a clip with its saved settings (charges tokens)
get_export_status(export_id)Poll an export; completed → temporary download_url
list_compilations(source_project_id?) / get_compilation(id)Cross-project clip collections
list_social_accounts()Connected channels for scheduling
schedule_post(...)Schedule an export to publish (idempotent on retry)
list_scheduled_posts(from_date, to_date)Posting calendar range

Development

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

來源:README.md,提交 27e7faa

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。