watch-cli — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер watch-cli для Claude Code передаёт агенту видео кадрами и транскриптом. Агент превращает ролики с YouTube, X или TikTok в схему, ноутбук или шпаргалку.
MIT ★ 260 обновлён 2026-09-13
claude mcp add --env KYMA_API_KEY=<KYMA_API_KEY> --env GROQ_API_KEY=<GROQ_API_KEY> --env WATCH_AUDIO_MODE=<WATCH_AUDIO_MODE> --transport stdio mcp-server -- npx -y @sonpiaz/watch-cli-mcpЧто делает watch-cli
Сервер регистрирует один инструмент, watch. Ему передают ссылку на видео с YouTube, X / Twitter, LinkedIn, TikTok, Vimeo, Reddit или Facebook и, если нужно, число кадров от 1 до 64 (без указания берётся 8). В ответ приходит JSON от CLI без правок: кадры, снятые через равные промежутки, и транскрипт. По ним агент может набросать архитектурную схему или собрать запускаемый ноутбук.
Сам сервер — процесс Node.js 18 или новее. Он общается по stdio и просто вызывает команду watch. Без неё в PATH ничего не заработает: CLI в пакет не входит, его ставят отдельно.
Ошибки приходят с меткой tag=... в тексте. Если скачивание упёрлось в авторизацию или регион (download-auth, download-region), это ошибка параметров: можно передать cookies или другую ссылку. Когда не получился только транскрипт (код 4), кадры всё равно вернутся, а transcript будет null.
Какие задачи решает
- разобрать ролик с YouTube или TikTok, не смотря его целиком
- набросать архитектурную схему по видео-разбору системы
- собрать запускаемый ноутбук по туториалу из X / Twitter
- превратить видеоурок в шпаргалку по шагам
- снять с видео нужное число кадров, от 1 до 64
Примеры запросов агенту
- Вызови
watchдля этой ссылки на YouTube и нарисуй по видео архитектурную схему - Разбери ролик из X через
watchна 8 кадрах и собери по нему запускаемый ноутбук - Посмотри видео с Vimeo через watch-cli и сделай шпаргалку по шагам
Как установить watch-cli
Командой платформы
claude mcp add --env KYMA_API_KEY=<KYMA_API_KEY> --env GROQ_API_KEY=<GROQ_API_KEY> --env WATCH_AUDIO_MODE=<WATCH_AUDIO_MODE> --transport stdio mcp-server -- npx -y @sonpiaz/watch-cli-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add mcp-server --env KYMA_API_KEY=<KYMA_API_KEY> --env GROQ_API_KEY=<GROQ_API_KEY> --env WATCH_AUDIO_MODE=<WATCH_AUDIO_MODE> -- npx -y @sonpiaz/watch-cli-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@sonpiaz/watch-cli-mcp"
],
"env": {
"KYMA_API_KEY": "<KYMA_API_KEY>",
"GROQ_API_KEY": "<GROQ_API_KEY>",
"WATCH_AUDIO_MODE": "<WATCH_AUDIO_MODE>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sonpiaz/watch-cli-mcp"
],
"env": {
"KYMA_API_KEY": "<KYMA_API_KEY>",
"GROQ_API_KEY": "<GROQ_API_KEY>",
"WATCH_AUDIO_MODE": "<WATCH_AUDIO_MODE>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e KYMA_API_KEY=<KYMA_API_KEY> -e GROQ_API_KEY=<GROQ_API_KEY> -e WATCH_AUDIO_MODE=<WATCH_AUDIO_MODE> mcp-server npx -y @sonpiaz/watch-cli-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о watch-cli
Как установить watch-cli в Claude Code?
Выполните claude mcp add watch-cli -e KYMA_API_KEY=<KYMA_API_KEY> -e GROQ_API_KEY=<GROQ_API_KEY> -- npx -y @sonpiaz/watch-cli-mcp. Отдельно нужны Node.js 18 или новее и CLI watch в PATH.
Что делает watch-cli?
Сервер даёт агенту инструмент watch: по ссылке на видео из соцсети он возвращает кадры и транскрипт одним JSON. Из этого агент собирает схему, ноутбук, компонент или шпаргалку.
Что вернётся, если у видео не получилось взять транскрипт?
Вызов завершится без ошибки (isError: false): кадры будут на месте, transcript станет null, а в JSON появится exit_code: 4. По этому полю агент понимает, что результат частичный.