Skip to main content
Glama

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),不会自动清理——如果磁盘空间重要,请定期清理。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers