NV

nekyialabs/video-watch-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

11 stars 4 forks 质量 80 趋势 32MIT

Let AI agents watch videos — cloud-hosted MCP server with transcript + frame extraction for TikTok, YouTube, and 1000+ platforms

概览

Let Claude "watch" videos with you. Send a TikTok, YouTube, or any video link - Claude sees the frames and reads the transcript. No local processing. Works on Claude Desktop, Claude mobile, anywhere MCP works. 1. You send Claude a video link 2. Claude picks the right tool (or you tell it which) 3. Cloud service downloads, extracts what's needed 4. Claude receives just what it needs - no context bloat 5. You watch it "together" Go to modal.com and sign up. Free tier gives you $30/month in credits - enough for thousands of short videos. (Get your token from Modal's dashboard after signup) You'll get a URL like: https://yourusername--video-watch-mcp-mcp-server.modal.run %APPDATA%\Claude\claude_desktop_config.json ~/Library/Application Support/Claude/claude_desktop_config.json Restart Claude Desktop. Send any video link and ask Claude to watch it:

README

以下为原文 README 节选,完整内容请查看原文。

Video Watch MCP

Let Claude “watch” videos with you. Send a TikTok, YouTube, or any video link - Claude sees the frames and reads the transcript.

Fully cloud-hosted. No local processing. Works on Claude Desktop, Claude mobile, anywhere MCP works.

What it does

Three tools, pick based on content:

Tool Returns Best for
video_listen Transcript only Talking heads, podcasts, commentary
video_see Frames only Dance, visual art, memes, scenery
watch_video Both When audio AND visuals both matter
  1. You send Claude a video link
  2. Claude picks the right tool (or you tell it which)
  3. Cloud service downloads, extracts what’s needed
  4. Claude receives just what it needs - no context bloat
  5. You watch it “together”

Quick Start (5 minutes)

1. Create a Modal account

Go to modal.com and sign up. Free tier gives you $30/month in credits - enough for thousands of short videos.

2. Install Modal CLI

pip install modal
modal token set --token-id YOUR_TOKEN_ID --token-secret YOUR_TOKEN_SECRET

(Get your token from Modal’s dashboard after signup)

3. Deploy

git clone https://github.com/nekyialabs/video-watch-mcp.git
cd video-watch-mcp
modal deploy mcp_remote.py

You’ll get a URL like: https://yourusername--video-watch-mcp-mcp-server.modal.run

4. Add to Claude Desktop

Edit your claude_desktop_config.json:

Windows: %APPDATA%\Claude\claude_desktop_config.json Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

Add under mcpServers:

{
  "mcpServers": {
    "video-watch": {
      "url": "https://yourusername--video-watch-mcp-mcp-server.modal.run"
    }
  }
}

5. Use it

Restart Claude Desktop. Send any video link and ask Claude to watch it:

“Watch this with me: https://tiktok.com/…”

Claude will see the frames and read the transcript.

Supported Platforms

Anything yt-dlp supports:

  • TikTok
  • YouTube
  • Instagram Reels
  • Twitter/X videos
  • Reddit videos
  • Facebook
  • Vimeo
  • And 1000+ more

Cost

With Modal’s free tier ($30/month credits):

Video Length Approx. Cost Videos per Month
30 sec ~$0.002 ~15,000
5 min ~$0.01 ~3,000
30 min ~$0.05 ~600

You’ll never hit the limit with normal use.

How it works

You send a link
       ↓
Claude calls watch_video(url)
       ↓
Modal spins up a container with ffmpeg + whisper
       ↓
yt-dlp downloads the video
       ↓
ffmpeg extracts frames (with timestamps burned in)
       ↓
Whisper transcribes the audio
       ↓
Returns frames as images + transcript text
       ↓
Claude sees everything, you discuss it together

Files

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "video-watch": { "url": "https://yourusername--video-watch-mcp-mcp-server.modal.run" } } }