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 クライアントから動画を取り込み、処理状況を監視し、クリップを閲覧し、エクスポートを実行し、投稿を予約できます。

• ユーザーの API キーを使って、パブリック REST API（https://api.clipmaster.app/api/v1）のみと通信します。データベースや内部サービスにはアクセスしません。
• 設計上、取り込みは URL のみです（LLM ツール呼び出し経由でローカルファイルをストリーミングするのは実用的ではありません）。アカウント管理（キー、請求、OAuth 接続）は対象外です。API でもキー認証によるこれらのルートへのアクセスは拒否されます。

要件

• Python 3.10+
• ClipMaster API キー（有料プラン）：ウェブアプリ → Settings → API access

インストール

このリポジトリのチェックアウトから：

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 に保存できます。 これにより、クライアント設定ファイルやシェル履歴にキーが残りません。

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)	1 つのクリップの詳細を取得します
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