video-watcher MCP 服务器

一个 MCP 服务器，让 Claude Desktop 能够"观看"来自 YouTube、Instagram、Facebook 或直接视频 URL（mp4/webm 等）的视频，并回答关于这些视频的问题。

功能

对于任何受支持的 URL，服务器会：

1. 使用 yt-dlp 下载视频（支持 YouTube、Instagram、Facebook 以及数百个其他网站，对于纯文件 URL 还会回退到原始 HTTP 下载）。

2. 提取文字记录——如果可用，通过 youtube-transcript-api 获取 YouTube 字幕，否则通过 faster-whisper 进行音频转写。

3. 使用 OpenCV 提取 5 个关键帧（在视频时间轴上采样）作为 base64 JPEG。

结果按 URL 缓存在进程生命周期内的内存中，因此对同一视频调用多个工具只会下载/转写一次。

Related MCP server: Video MCP

工具

• watch_video(url) — 完整分析：标题、时长、文字记录、关键帧。

• summarize_video(url) — 约 200 字的摘要 + 要点列表。

• answer_about_video(url, question) — 文字记录 + 关键帧，让 Claude 能够回答关于视频的具体问题。

设置

cd D:\Projects\video-mcp-server
pip install -r requirements.txt

你还需要在 PATH 中有 ffmpeg（yt-dlp 进行混流和 faster-whisper 进行音频解码都需要它）。在 Windows 上，通过 winget install ffmpeg 安装，或从 https://ffmpeg.org 下载并添加到 PATH。

先独立测试服务器：

python video_mcp_server.py

它应该等待在 stdio 上（没有输出 = 正常；它会记录到 stderr）。

连接到 Claude Desktop

编辑 %APPDATA%\Claude\claude_desktop_config.json（如果不存在则创建）并合并：

{
  "mcpServers": {
    "video-watcher": {
      "command": "python",
      "args": ["D:\\Projects\\video-mcp-server\\video_mcp_server.py"]
    }
  }
}

如果你在其他位置克隆了此项目，请调整路径。如果 python 不在 Claude Desktop 环境中的 PATH 上，请改用完整的解释器路径，例如 "C:\\Users\\<you>\\AppData\\Local\\Programs\\Python\\Python311\\python.exe"。

编辑配置后完全退出并重新打开 Claude Desktop（在 Windows 上仅关闭窗口是不够的——请使用系统托盘图标退出）。

测试

连接后尝试以下操作：

• watch_video("https://www.youtube.com/watch?v=dQw4w9WgXcQ")

• summarize_video("https://www.youtube.com/shorts/<some-short-id>")

• answer_about_video("https://www.instagram.com/reel/<reel-id>/", "正在推广什么产品？")

直接询问 Claude，例如："观看这个视频并总结一下："

注意事项与限制

• Instagram：公开帖子和 Reels 可通过 yt-dlp 使用。需要登录的私人账户或帖子会以明确的错误信息失败——此服务器不存储或使用 Instagram 凭据。instagrapi 被列为可选依赖项以供未来扩展，但当前代码路径不需要它。

• Facebook：仅限公开视频；同样存在登录墙限制。

• Whisper 回退：第一次需要转写的调用将在首次使用时下载 base Whisper 模型（约 150MB）。

• 速率限制：平台可能会限制重复请求；服务器会显示明确的"速率受限，请稍后重试"错误，而不是挂起。

• 存储：下载的视频会写入临时缓存目录（%TEMP%\video_mcp_cache），不会自动清理——如果磁盘空间重要，请定期清理。