English Français العربية

io.github.n0Sp00n/clipmaster-mcp

السجل الرسمي الوسائط والتصميم

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package clipmaster-mcp
Claude Code 
claude mcp add clipmaster-mcp -e 'CLIPMASTER_API_KEY=<your clipmaster_api_key>' -- uvx clipmaster-mcp==0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "clipmaster-mcp": {
            "command": "uvx",
            "args": [
                "clipmaster-mcp==0.1.1"
            ],
            "env": {
                "CLIPMASTER_API_KEY": "<your clipmaster_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • CLIPMASTER_API_KEY إلزامي سري ClipMaster API key (cm_live_...), created in the ClipMaster app under Settings -> API access. Available on paid plans.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. clipmaster-mcp
  2. Requirements
  3. Install
  4. Configure
  5. Tools
  6. Development

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:

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:

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
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_..." }
    }
  }
}

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

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

الأسئلة الشائعة

ما هو io.github.n0Sp00n/clipmaster-mcp؟

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

كيف أثبّت io.github.n0Sp00n/clipmaster-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add clipmaster-mcp -e 'CLIPMASTER_API_KEY=<your clipmaster_api_key>' -- uvx clipmaster-mcp==0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.n0Sp00n/clipmaster-mcp إلى مفتاح API؟

نعم. يتطلب CLIPMASTER_API_KEY، وتضبطها في إعداداته.

هل io.github.n0Sp00n/clipmaster-mcp مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.n0Sp00n/clipmaster-mcp؟

ينشره n0Sp00n. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.