Ermöglicht es AI-Agents, Social-Media-Videos zu verarbeiten, indem Frames und Transkripte für eine automatisierte Analyse und Dokumentation extrahiert werden.
Auch bekannt als sonpiaz/watch-cli, @sonpiaz/watch-cli-mcp
- Stars
- 260
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 0.3.1
- Letzter Commit
- 13. Sept. 2026
- Lizenz
- MIT
Was ist watch-cli MCP?
Ermöglicht es AI-Agents, Social-Media-Videos zu verarbeiten, indem Frames und Transkripte für eine automatisierte Analyse und Dokumentation extrahiert werden.
Zusammenfassung generiert aus dem README des Projekts
Über watch-cli MCP server
Dieser Server ermöglicht es, visuelle Frames und Transkripte aus Social-Media-Videos für eine automatisierte Dokumentation zu extrahieren. Entwickler, die MCP-fähige Agents wie Claude Desktop, Cursor oder Windsurf nutzen, können eine Video-URL bereitstellen, um strukturierte Daten für die Erstellung von Architekturdiagrammen, Funktionsbeschreibungen oder Schritt-für-Schritt-Anleitungen zu erhalten. Das Ganze funktioniert über ein Wrapper-Verfahren um das watch-cli Tool, das auf deinem lokalen System installiert und in deinem PATH verfügbar sein muss.
Der Server stellt ein einzelnes watch Tool bereit, das Video-URLs von Plattformen wie YouTube, X, TikTok, LinkedIn, Vimeo, Reddit und Facebook akzeptiert. Du kannst die Anzahl der gleichmäßig verteilten Frames angeben, die extrahiert werden sollen (Limit zwischen 1 und 64 Frames). Der Server kommuniziert via stdio und verarbeitet verschiedene Fehlerzustände, wie etwa Authentifizierungs- oder regionale Download-Probleme, indem er spezifische Tags an den Client zurückgibt, um eine Fehlerbehebung zu ermöglichen.
Was du damit machen kannst
- 1Technische Dokumentation aus Videos generierenLass einen AI-Agent ein Social-Video in ein strukturiertes Architekturdiagramm oder ein ausführbares Notebook umwandeln.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du watch-cli MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenwatch-cli MCP in Claude Code installieren
$ claude mcp add --env 'GROQ_API_KEY=<YOUR_GROQ_API_KEY>' --env 'KYMA_API_KEY=<YOUR_KYMA_API_KEY>' watch-cli -- npx -y @sonpiaz/watch-cli-mcpwatch-cli MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"watch-cli": {
"command": "npx",
"args": [
"-y",
"@sonpiaz/watch-cli-mcp"
],
"env": {
"GROQ_API_KEY": "<YOUR_GROQ_API_KEY>",
"KYMA_API_KEY": "<YOUR_KYMA_API_KEY>"
}
}
}
}watch-cli MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"watch-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sonpiaz/watch-cli-mcp"
],
"env": {
"GROQ_API_KEY": "<YOUR_GROQ_API_KEY>",
"KYMA_API_KEY": "<YOUR_KYMA_API_KEY>"
}
}
}
}watch-cli MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"watch-cli","type":"stdio","command":"npx","args":["-y","@sonpiaz/watch-cli-mcp"],"env":{"GROQ_API_KEY":"<YOUR_GROQ_API_KEY>","KYMA_API_KEY":"<YOUR_KYMA_API_KEY>"}}'watch-cli MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"watch-cli": {
"command": "npx",
"args": [
"-y",
"@sonpiaz/watch-cli-mcp"
],
"env": {
"GROQ_API_KEY": "<YOUR_GROQ_API_KEY>",
"KYMA_API_KEY": "<YOUR_KYMA_API_KEY>"
}
}
}
}watch-cli MCP in Codex installieren
$ codex mcp add watch-cli --env 'GROQ_API_KEY=<YOUR_GROQ_API_KEY>' --env 'KYMA_API_KEY=<YOUR_KYMA_API_KEY>' -- npx -y @sonpiaz/watch-cli-mcpwatch-cli MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.watch-cli] command = "npx" args = ["-y", "@sonpiaz/watch-cli-mcp"] [mcp_servers.watch-cli.env] GROQ_API_KEY = "<YOUR_GROQ_API_KEY>" KYMA_API_KEY = "<YOUR_KYMA_API_KEY>"
watch-cli MCP in Gemini CLI installieren
$ gemini mcp add -s user -e 'GROQ_API_KEY=<YOUR_GROQ_API_KEY>' -e 'KYMA_API_KEY=<YOUR_KYMA_API_KEY>' watch-cli npx -- -y @sonpiaz/watch-cli-mcpwatch-cli MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"watch-cli": {
"command": "npx",
"args": [
"-y",
"@sonpiaz/watch-cli-mcp"
],
"env": {
"GROQ_API_KEY": "<YOUR_GROQ_API_KEY>",
"KYMA_API_KEY": "<YOUR_KYMA_API_KEY>"
}
}
}
}Konfiguration
GROQ_API_KEYSecretGroq API key for direct BYOK transcription (alternative to Kyma). Set this instead of KYMA_API_KEY if you prefer direct provider.
KYMA_API_KEYSecretKyma API key (default backend). Get one at https://kymaapi.com — first $0.50 free, then pay-per-use (~$0.05 per 1-hour video). Optional if WATCH_AUDIO_MODE=local (whisper.cpp) or GROQ_API_KEY is set instead.
WATCH_AUDIO_MODEBackend routing override. Values: kyma (default), byok (use GROQ_API_KEY), local (whisper.cpp on $PATH, fully offline).
| Name | Beschreibung | Typ |
|---|---|---|
| GROQ_API_KEY | Groq API key for direct BYOK transcription (alternative to Kyma). Set this instead of KYMA_API_KEY if you prefer direct provider. | Secret |
| KYMA_API_KEY | Kyma API key (default backend). Get one at https://kymaapi.com — first $0.50 free, then pay-per-use (~$0.05 per 1-hour video). Optional if WATCH_AUDIO_MODE=local (whisper.cpp) or GROQ_API_KEY is set instead. | Secret |
| WATCH_AUDIO_MODE | Backend routing override. Values: kyma (default), byok (use GROQ_API_KEY), local (whisper.cpp on $PATH, fully offline). |
Automatisierte Checks
Geluften am 12. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarBestanden
- Open Source Lizenz (OSI)Bestanden
- Commit oder Release im letzten JahrBestanden
- Package-Name ähnelt keinem populären PackageBestanden
- Remote Endpoint nutzt HTTPSNicht geprüft
- Destruktive Tools sind markiertNicht geprüft
- Keine versteckten Anweisungen an das ModellBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenBestanden
README
Auf GitHub ansehen@sonpiaz/watch-cli-mcp
MCP (Model Context Protocol) stdio server that exposes watch-cli as a callable tool.
Watch any social video → get an architecture diagram, working component, runnable notebook, or step-by-step cheat sheet — automatically.
A single MCP server reaches every MCP-capable agent runtime — Claude Desktop, Claude Code, Cursor, OpenClaw, hermes-agent, Cline, Continue.dev, Windsurf, Zed, Codex, Kiro, VS Code Copilot — without per-IDE plugin work. This package wraps watch-cli so any of them can call it through one channel.
Prerequisites
-
Node.js >= 18.
-
The
watchCLI installed and onPATH. Install with:curl -fsSL https://raw.githubusercontent.com/sonpiaz/watch-cli/main/install.sh | bash
The MCP server shells out to watch; it does not bundle the CLI.
Install
npm install -g @sonpiaz/watch-cli-mcp
Or run on demand via npx:
npx -y @sonpiaz/watch-cli-mcp
The binary is watch-cli-mcp. It reads JSON-RPC on stdin, writes JSON-RPC on stdout, and logs to stderr.
Tool
One tool is registered: watch.
Input schema:
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "A social video URL. Supported: YouTube, X / Twitter, LinkedIn, TikTok, Vimeo, Reddit, Facebook."
},
"frames": {
"type": "integer",
"minimum": 1,
"maximum": 64,
"description": "Number of evenly-spaced frames to extract. Default 8."
}
},
"required": ["url"],
"additionalProperties": false
}
Output: the v1 JSON object from docs/output-schema.md, passed through verbatim. Read the schema for the field reference.
Error mapping
| CLI exit | MCP response |
|---|---|
0 |
Tool result with the v1 JSON as content[0].text. |
2 |
InternalError, message includes tag=missing-dep:<bin>. |
3 download-auth / download-region |
InvalidParams, message includes the tag — caller can recover with cookies or a different URL. |
3 download-network / download-other |
InternalError, message includes the tag. |
4 (partial success) |
Tool result with isError: false. Frames populated, transcript null, exit_code: 4 in the JSON payload. Caller branches on obj.exit_code === 4. |
64 |
InvalidParams, message includes tag=usage-error. |
1 / other |
InternalError, message includes the CLI stderr tail (≤ 1 KB). |
Tags always ride in the MCP error message field so callers can grep for the same tag=... token they would see in CLI stderr.
Client configuration
Claude Desktop
Config path:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
Merge into the existing mcpServers object:
{
"mcpServers": {
"watch-cli": {
"command": "npx",
"args": ["-y", "@sonpiaz/watch-cli-mcp"]
}
}
}
Restart Claude Desktop after editing.
Cursor
Config path: .cursor/mcp.json (project-scoped) or ~/.cursor/mcp.json (user-global). Same mcpServers object shape as Claude Desktop:
{
"mcpServers": {
"watch-cli": {
"command": "npx",
"args": ["-y", "@sonpiaz/watch-cli-mcp"]
}
}
}
hermes-agent
Config path: optional-skills/mcp.json inside the hermes-agent install, or ~/.hermes-agent/mcp.json user-global. Same mcpServers shape as above.
Other MCP clients
Any MCP-capable agent that accepts an npx command will work with the snippet above. Substitute the client's config path; the command / args pair is portable.
Build from source
git clone https://github.com/sonpiaz/watch-cli
cd watch-cli/mcp-server
npm install
npm run build
node dist/index.js
License
MIT. © 2026 Son Piaz.
watch-cli MCP Fragen
Wie füge ich watch-cli MCP zu Claude Code hinzu?
Führe claude mcp add --env 'GROQ_API_KEY=<YOUR_GROQ_API_KEY>' --env 'KYMA_API_KEY=<YOUR_KYMA_API_KEY>' watch-cli -- npx -y @sonpiaz/watch-cli-mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich watch-cli MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Social-Media-Plattformen werden unterstützt?
Das Tool unterstützt YouTube, X / Twitter, LinkedIn, TikTok, Vimeo, Reddit und Facebook.
Muss ich das watch CLI separat installieren?
Ja, der MCP server nutzt das watch CLI über Shell-Aufrufe und liefert es nicht mit, daher muss es auf deinem PATH installiert sein.