video-watcher MCP 서버

Claude Desktop이 YouTube, Instagram, Facebook 또는 직접 비디오 URL(mp4/webm 등)의 동영상을 "시청"하고 그에 대한 질문에 답할 수 있게 해주는 MCP 서버입니다.

기능

지원되는 모든 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"]
    }
  }
}

다른 위치에 클론한 경우 경로를 조정하세요. Claude Desktop 환경 내에서 python이 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>/", "What product is being promoted?")

Claude에게 직접 물어보세요(예: "이 동영상을 보고 요약해 줘: ").

참고 사항 및 제한 사항

• Instagram: 공개 게시물/릴은 yt-dlp를 통해 작동합니다. 비공개 계정이나 로그인이 필요한 게시물은 명확한 오류와 함께 실패합니다 — 이 서버는 Instagram 자격 증명을 저장하거나 사용하지 않습니다. instagrapi는 향후 확장을 위한 선택적 종속성으로 나열되어 있지만 현재 코드 경로에서는 필요하지 않습니다.

• Facebook: 공개 동영상만 가능합니다. 동일한 로그인 장벽 제한이 적용됩니다.

• Whisper 대체: 전사가 필요한 첫 번째 호출은 처음 사용 시 base Whisper 모델(약 150MB)을 다운로드합니다.

• 속도 제한: 플랫폼이 반복 요청을 제한할 수 있습니다. 서버는 멈추지 않고 명확한 "속도 제한됨, 나중에 다시 시도하세요" 오류를 표시합니다.

• 저장 공간: 다운로드된 동영상은 임시 캐시 디렉터리(%TEMP%\video_mcp_cache)에 기록되며 자동으로 정리되지 않습니다 — 디스크 공간이 중요하다면 주기적으로 비우세요.