Watch Cli

io.github.sonpiaz由 GitHub 账号 sonpiaz 发布v0.3.1更新于 Oct 28, 2026

Hand any social video to your AI agent — frames + transcript bundled. MCP server for watch-cli.

已验证STDIO仅桌面媒体与设计AI 与机器学习

概览

AI 生成的概览

把 watch CLI 封装成单个 MCP 工具，让助手从社交视频链接获取等间隔画面帧和文字稿。

可以做什么
  • 按链接抓取社交视频，并以一个 JSON 对象返回抽取的画面帧和文字稿
  • 可指定抽取的等间隔帧数，范围 1 到 64，默认 8
  • 支持 YouTube、X/Twitter、LinkedIn、TikTok、Vimeo、Reddit 和 Facebook 链接
  • 对缺少依赖、下载鉴权或地区限制、网络失败和用法错误返回带标签的错误信息
  • 识别部分成功的情况：有画面帧但文字稿为空
适用场景
适合让助手查看并总结社交视频，或据此生成架构图、速查表、笔记等，而无需手动下载视频。适用于已安装 watch CLI 并具备转写后端的智能体环境。
运行要求
需要 Node.js 18 或更高版本，并已安装 watch CLI 且位于 PATH 中（服务器调用它，不内置）。需要转写后端：默认使用 KYMA_API_KEY，或设置 WATCH_AUDIO_MODE=byok 配合 GROQ_API_KEY，或设置 WATCH_AUDIO_MODE=local 并使用 PATH 中的 whisper.cpp 离线运行。需要访问视频来源的网络。
安装前请注意
需要第三方 API 密钥：KYMA_API_KEY 在少量免费额度后按使用量计费，GROQ_API_KEY 的内容会发送给 Groq。README 的安装步骤把远程脚本直接通过管道交给 bash 执行，运行前应先审阅。视频链接会发送给转写后端和视频站点，部分来源可能需要 cookies 才能绕过鉴权或地区限制。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Watch Cli，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@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 watch CLI installed and on PATH. Install with:

    bash
    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

bash
npm install -g @sonpiaz/watch-cli-mcp

Or run on demand via npx:

bash
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:

json
{  "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 exitMCP response
0Tool result with the v1 JSON as content[0].text.
2InternalError, message includes tag=missing-dep:<bin>.
3 download-auth / download-regionInvalidParams, message includes the tag — caller can recover with cookies or a different URL.
3 download-network / download-otherInternalError, 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.
64InvalidParams, message includes tag=usage-error.
1 / otherInternalError, 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:

json
{  "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:

json
{  "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

bash
git clone https://github.com/sonpiaz/watch-clicd watch-cli/mcp-servernpm installnpm run buildnode dist/index.js

License

MIT. © 2026 Son Piaz.

来源：mcp-server/README.md，提交 06beafb

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.3.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分