io.github.n0Sp00n/clipmaster-mcp
AI video clipping with ClipMaster (clipmaster.app): clips, exports, scheduling.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
clipmaster-mcpclaude mcp add clipmaster-mcp -e 'CLIPMASTER_API_KEY=<your clipmaster_api_key>' -- uvx clipmaster-mcp==0.1.1
{
"mcpServers": {
"clipmaster-mcp": {
"command": "uvx",
"args": [
"clipmaster-mcp==0.1.1"
],
"env": {
"CLIPMASTER_API_KEY": "<your clipmaster_api_key>"
}
}
}
}
Variables d'environnement
CLIPMASTER_API_KEYobligatoire secret ClipMaster API key (cm_live_...), created in the ClipMaster app under Settings -> API access. Available on paid plans.
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
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 var | Required | Meaning |
|---|---|---|
CLIPMASTER_API_KEY | yes* | Your cm_live_… API key |
CLIPMASTER_API_BASE | no | Override 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
| Tool | What 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
Questions fréquentes
Qu'est-ce que io.github.n0Sp00n/clipmaster-mcp ?
AI video clipping with ClipMaster (clipmaster.app): clips, exports, scheduling.
Comment installer io.github.n0Sp00n/clipmaster-mcp ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add clipmaster-mcp -e 'CLIPMASTER_API_KEY=<your clipmaster_api_key>' -- uvx clipmaster-mcp==0.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.n0Sp00n/clipmaster-mcp ?
Oui. Il attend CLIPMASTER_API_KEY, à renseigner dans sa configuration.
io.github.n0Sp00n/clipmaster-mcp est-il open source ?
Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.
Qui maintient io.github.n0Sp00n/clipmaster-mcp ?
Il est publié par n0Sp00n. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.