English Français العربية

io.github.thestockgoatballs/clipspeed-mcp

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

AI video, images, AI influencers, character swaps and clipping from Claude or ChatGPT.

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

التثبيت

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

Remote (streamable-http)
Claude Code 
claude mcp add --transport http clipspeed-mcp 'https://api.clipspeed.ai/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "clipspeed-mcp": {
            "type": "http",
            "url": "https://api.clipspeed.ai/mcp"
        }
    }
}
NPM package clipspeed-mcp
Claude Code 
claude mcp add clipspeed-mcp -e 'CLIPSPEED_API_KEY=<your clipspeed_api_key>' -e 'CLIPSPEED_BASE_URL=https://api.clipspeed.ai' -- npx -y clipspeed-mcp@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "clipspeed-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "clipspeed-mcp@1.0.1"
            ],
            "env": {
                "CLIPSPEED_API_KEY": "<your clipspeed_api_key>",
                "CLIPSPEED_BASE_URL": "https://api.clipspeed.ai"
            }
        }
    }
}

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

  • CLIPSPEED_API_KEY إلزامي سري Your ClipSpeed API key (csai_live_...), from https://www.clipspeed.ai/dashboard/api-key/
  • CLIPSPEED_BASE_URL API base URL. Defaults to https://api.clipspeed.ai

التوثيق

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

المحتويات
  1. clipspeed-mcp
  2. Install
  3. Environment
  4. Tools (npm package / local stdio)
  5. The demo prompt
  6. Security
  7. License

clipspeed-mcp

Turn any video or live stream into scored, captioned, ready-to-post vertical clips — right inside Claude, Cursor, Cline, or Windsurf.

ClipSpeedAI ships two MCP transports, and they expose different tools:

Hosted (remote)This npm package (local)
Transportstreamable-http at https://api.clipspeed.ai/mcpstdio
AuthOAuth — one click, no API keyCLIPSPEED_API_KEY
Installnonenpx clipspeed-mcp
Clip a LIVE stream while it airsyes — clip_livestream, check_livestream, extend_livestream, stop_livestreamno
Save .mp4s to your disknoyes — download_clip
Schedule postsvia publish_to_youtubeschedule_post (5 platforms)

Most people want the hosted server — it needs no install, no API key, and it is the only one that can clip a stream that is still running. Use this npm package when you specifically need finished files written to your local disk.

Requires a ClipSpeedAI paid plan or the $1 trial. For the npm package, get your key at **https://www.clipspeed.ai/dashboard/api-key/** — keys look like csai_live_....

Always pin clipspeed-mcp@1.0.1. Pinning keeps a bad publish from silently upgrading your setup.

Install

Claude Desktop (one command)
npx clipspeed-mcp@1.0.1 install

It prompts for your API key and writes the clipspeed server into your Claude Desktop config for you. You can also pass the key directly:

npx clipspeed-mcp@1.0.1 install --key csai_live_your_key

Then quit and reopen Claude Desktop.

Claude Code
claude mcp add clipspeed -- npx -y clipspeed-mcp@1.0.1
export CLIPSPEED_API_KEY=csai_live_your_key
Cursor / Cline / Windsurf

Add this to your MCP servers config (~/.cursor/mcp.json, Cline's MCP settings, or Windsurf's mcp_config.json):

{
  "mcpServers": {
    "clipspeed": {
      "command": "npx",
      "args": ["-y", "clipspeed-mcp@1.0.1"],
      "env": { "CLIPSPEED_API_KEY": "csai_live_your_key" }
    }
  }
}

The hosted server authenticates with OAuth, so there is no key to copy and nothing to install:

claude mcp add --transport http clipspeed https://api.clipspeed.ai/mcp

Your client opens a browser once, you approve, and it is connected. In claude.ai or ChatGPT, add it as a custom connector with the same URL.

Hosted tools (10):

ToolDoes
submit_to_clipspeedVideo URL → a clip job.
check_clipsPoll a job → finished clips with viral scores.
clip_livestreamAttach to a stream that is STILL LIVE and cut clips while it airs.
check_livestreamClips produced so far from a live session.
extend_livestreamKeep clipping past the original window.
stop_livestreamEnd the live session.
discover_trendingFastest-growing recent video in a niche.
list_templatesAvailable caption/layout templates.
creator_packTitles, hooks and hashtags for a finished clip.
publish_to_youtubePublish a finished clip to YouTube.

The four livestream tools exist only on the hosted server. If you want to clip a Twitch, Kick or YouTube stream while it is running, use the hosted transport — the npm package cannot do it. Conversely, only the npm package can write .mp4 files to your local disk.

Environment

VarRequiredDefaultNotes
CLIPSPEED_API_KEYyes (to serve)—Your personal csai_live_ key.
CLIPSPEED_BASE_URLnohttps://api.clipspeed.aiOverride for testing.

Node >= 18 (uses global fetch).

Tools (npm package / local stdio)

These are the tools this package exposes. For the hosted server's tool set — including the four livestream tools — see Hosted above.

ToolDoes
clip_videoVideo URL → a clip job (job_id). Options: aspect_ratio, caption_style, clip_count, platform.
get_clip_statusPoll a job_id → status + finished clips (title, viral_score, duration, video_url).
list_clipsList your recent clip jobs to find a past job_id.
download_clipSave the .mp4 files to ~/Downloads — all clips, or one by clip_index. Skips files > 500MB.
get_usageCredits remaining / total / used this month, plan, trial status.
discover_trendingFind the fastest-growing recent video in a niche to clip. ClipSpeedAI's differentiator.
schedule_postSchedule a finished clip to tiktok / youtube / instagram / x / linkedin.
list_scheduled_postsReview scheduled / posted / failed posts.
cancel_scheduled_postCancel a post that's still scheduled.
restyle_captionsRe-caption a project in a new style without re-clipping.

Caption styles: karaoke (default), hormozi, beasty, fire, youshaei, cinematic, bold. Aspect ratios: 9:16 (default), 1:1, 16:9.

To let ClipSpeedAI publish to your socials, connect each platform in the ClipSpeedAI app first (Scheduler). schedule_post posts under those connections.

The demo prompt

Clip this video into 9:16 shorts with Hormozi captions, then download the top 3 to my Downloads folder: https://youtu.be/…

Claude runs clip_video → polls get_clip_status → download_clip → the .mp4s land in ~/Downloads.

A Claude Skill (SKILL.md) ships with this package — it teaches the outcome-first flow (find → clip → check → download → schedule).

Security

  • Your API key is never logged. It only ever lands in your MCP client's config file (or your shell env).
  • Never commit your key or share it. Rotate it any time at https://www.clipspeed.ai/dashboard/api-key/.
  • Keys are tied to one account, rate-limited per plan, and hashed at rest on ClipSpeedAI's servers.

License

MIT

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

ما هو io.github.thestockgoatballs/clipspeed-mcp؟

AI video, images, AI influencers, character swaps and clipping from Claude or ChatGPT.

كيف أثبّت io.github.thestockgoatballs/clipspeed-mcp؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http clipspeed-mcp 'https://api.clipspeed.ai/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

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

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

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

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.thestockgoatballs/clipspeed-mcp؟

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

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