MV

maryfellowes/video-watch-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

14 stars 10 forks 품질 57 트렌드 20MIT

Let Claude watch videos with you - cloud-hosted MCP server that extracts frames and transcribes audio

개요

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 In Desktop settings go to Connectors. Find "Add Custom Connectors" button and paste the link. Name it anything that makes sense to you, like "Video MCP". Mobile app will connect automatically after that.

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/yourusername/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

In Desktop settings go to Connectors. Find “Add Custom Connectors” button and paste the link. Name it anything that makes sense to you, like “Video MCP”.

Save. Reload Desktop.

Mobile app will connect automatically after that.

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

  • mcp_remote.py - The full MCP server (deploy this)
  • video_watch.py - Standalone video processor with web endpoint (if you just want the API)
GitHub에서 전체 README 보기

설치

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

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →