Skip to main content
Glama
deenesjakoruzh
u2n4

video-url-analyzer-mcp

by u2n4
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

이것은 무엇인가요?

Video URL Analyzer MCP는 Claude(또는 MCP 호환 AI)가 YouTube, TikTok, Instagram 동영상을 분석할 수 있게 해주는 Model Context Protocol(MCP) 서버입니다. URL만 붙여넣으세요. Google의 Gemini API를 기반으로 오디오 및 시각적 분석을 수행하며, 자막 추출, AI 기반 인사이트 제공, 실행 가능한 튜토리얼 단계 추출까지 가능합니다.

기능

  • YouTube 분석 — Gemini API를 통한 직접 분석 (다운로드 불필요)

  • TikTok & Instagram — yt-dlp 다운로드 및 Gemini Files API를 사용한 비동기 작업 패턴

  • 전체 오디오 + 시각 분석 — 동영상 프레임과 오디오/음성을 모두 분석

  • 6가지 도구 — analyze, transcript, Q&A, watch & analyze, execute tutorials, check jobs

  • 이중 언어 — 아랍어 및 영어 프롬프트와 응답 지원

  • 비동기 작업 — 백그라운드 처리를 통해 Claude Desktop 타임아웃 충돌 방지

  • 보안 강화 — URL 허용 목록, SSRF 보호, 명령 주입 방지, 경로 탐색 차단

  • 무설정 설치 — uvx video-url-analyzer-mcp 명령어로 즉시 실행

지원 플랫폼

플랫폼

방식

속도

YouTube

직접 Gemini 분석 — 다운로드 불필요

즉시

TikTok

tikwm.com API (빠름) → yt-dlp 대체

~8초

Instagram

curl_cffi를 통한 페이지 스크랩 (빠름) → yt-dlp 대체

~10초

YouTube 동영상은 Gemini의 기본 동영상 이해 기능을 통해 직접 분석되므로 다운로드나 업로드 없이 최대 속도로 처리됩니다.

빠른 시작

옵션 1: uvx (권장)

uv가 필요합니다.

Claude Desktop -- claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "video-analyzer": {
      "command": "uvx",
      "args": ["video-url-analyzer-mcp"],
      "env": {
        "GEMINI_API_KEY": "your_key"
      }
    }
  }
}

Claude Code:

claude mcp add video-analyzer -s user -e GEMINI_API_KEY=your_key -- uvx video-url-analyzer-mcp

Cursor / VS Code -- .cursor/mcp.json 또는 .vscode/mcp.json에 추가:

{
  "servers": {
    "video-analyzer": {
      "command": "uvx",
      "args": ["video-url-analyzer-mcp"],
      "env": { "GEMINI_API_KEY": "your_key" }
    }
  }
}

Windsurf -- ~/.codeium/windsurf/mcp_config.json에 추가:

{
  "mcpServers": {
    "video-analyzer": {
      "command": "uvx",
      "args": ["video-url-analyzer-mcp"],
      "env": { "GEMINI_API_KEY": "your_key" }
    }
  }
}

옵션 2: pip 설치

pip install video-url-analyzer-mcp

옵션 3: 소스에서 설치

git clone https://github.com/u2n4/video-url-analyzer-mcp.git
cd video-url-analyzer-mcp
pip install -e .

도구

도구

기능

analyze_video

사용자 지정 프롬프트를 사용한 전체 오디오 + 시각 분석. 최첨단 멀티모달 이해를 위해 Gemini 사용.

get_transcript

화자 식별이 포함된 타임스탬프 자막 추출. 자동 감지를 통해 100개 이상의 언어 지원.

ask_about_video

질문하기 — "몇 명이 등장하나요?", "0:45에 나오는 브랜드는 무엇인가요?", "주요 논점을 요약해줘."

watch_and_analyze

기술 동영상에서 튜토리얼 단계, 셸 명령, 코드 스니펫, 파일 경로 추출.

execute_tutorial_steps

추출된 단계를 안전하게 검토한 후 확인을 거쳐 실행. 명령 및 경로 검증을 통한 샌드박스 환경.

check_analysis_job

TikTok/Instagram 비동기 다운로드의 백그라운드 작업 상태 확인.

작동 원리

YouTube — 동기식: URL이 즉시 Gemini API로 전송되어 즉각적인 분석 수행 (다운로드 없음).

TikTok & Instagram — 비동기식: yt-dlp를 통해 동영상을 다운로드하고 Gemini Files API에 업로드하여 분석한 뒤 정리합니다. 즉시 job_id를 반환하며 check_analysis_job으로 상태를 확인합니다.

사용 예시

# Full video analysis
analyze_video("https://www.youtube.com/watch?v=dQw4w9WgXcQ")

# Custom analysis prompt
analyze_video("https://www.tiktok.com/@user/video/123",
              prompt="List every product shown and estimate prices")

# Multilingual transcript extraction
get_transcript("https://www.instagram.com/reel/ABC123/", lang="ar")

# Ask specific questions about video content
ask_about_video("https://youtu.be/abc",
                question="What programming language is used in the tutorial?")

# Watch & build — extract tutorial steps
watch_and_analyze("https://www.youtube.com/watch?v=tutorial123")

아키텍처

구성 요소

역할

Gemini API

멀티모달 모델 — 단일 패스로 전체 오디오 + 시각적 이해

FastMCP 3.x

stdio 전송을 통한 MCP 프로토콜 프레임워크

yt-dlp + curl_cffi

봇 방지 우회를 위한 Chrome 브라우저 모방 동영상 다운로드

tikwm.com API

yt-dlp가 WAF에 의해 차단될 경우를 대비한 TikTok 빠른 경로

백그라운드 작업

Claude Desktop 타임아웃 방지를 위한 TikTok/Instagram 비동기 스레딩

video-url-analyzer-mcp/
├── pyproject.toml                    # Package metadata & dependencies
├── src/
│   └── video_url_analyzer_mcp/
│       ├── __init__.py               # Package init + version
│       ├── __main__.py               # python -m support
│       └── server.py                 # Main MCP server (all 6 tools)
├── .env.example                      # Environment variable template
├── llms.txt                          # AI-readable project summary
├── llms-install.md                   # AI-readable install guide
├── CONTRIBUTING.md
├── CHANGELOG.md
└── LICENSE

플랫폼 감지

URL은 자동으로 올바른 파이프라인으로 라우팅됩니다:

  • YouTube: youtube.com, youtu.be, youtube.com/shorts/

  • TikTok: tiktok.com, vm.tiktok.com, vt.tiktok.com

  • Instagram: instagram.com/reels/, instagram.com/reel/, instagram.com/p/

보안

이 서버는 포괄적인 위협 모델에 대비하여 강화되었습니다:

계층

보호 조치

SSRF

URL 허용 목록 — YouTube, TikTok, Instagram 도메인만 허용. 사설 IP, localhost, file:// 차단.

명령 주입

shell=False + shlex.split(). 위험한 명령 차단 목록 (rm -rf, 리버스 셸, eval, pipe-to-shell).

경로 탐색

25개 이상의 민감한 경로 패턴 차단 (.ssh, .aws, .env, 시스템 디렉터리, AppData).

TLS

모든 다운로드에 대한 전체 인증서 검증.

브라우저 쿠키

VIDEO_ANALYZER_COOKIES=true를 통한 선택적 사용. 기본값은 비활성화.

다운로드 크기

동영상당 100MB 하드 제한.

DoS 보호

최대 10개의 동시 백그라운드 작업. 1시간 후 자동 만료. 200개 분석 저장소 제한.

스키마 검증

실행 전 Gemini JSON 응답 검증. 응답 크기 500K 문자로 제한.

의존성

모든 버전은 pyproject.toml에 고정됨.

구성

변수

설명

기본값

GEMINI_API_KEY

Google Gemini API 키 (필수)

—

ANALYSES_DIR

분석 결과 저장 디렉터리

./analyses

VIDEO_ANALYZER_COOKIES

yt-dlp용 브라우저 쿠키 활성화

false

기술 스택

기술

목적

google-genai

Google Gemini API SDK

FastMCP

MCP 프로토콜 프레임워크

yt-dlp

동영상 다운로더

curl_cffi

브라우저 모방 (TLS 지문)

python-dotenv

환경 변수 로딩

문제 해결

문제

해결책

GEMINI_API_KEY not set

.env 파일을 생성하거나 환경 변수로 전달

TikTok 다운로드 실패

tikwm.com 대체 경로가 자동으로 활성화됨. curl_cffi가 설치되었는지 확인.

Instagram 다운로드 실패

브라우저 모방 지원을 위해 pip install curl_cffi 실행

Windows에서 ENOENT 발생

uvx video-url-analyzer-mcp 명령어를 사용

Claude Desktop 타임아웃

TikTok/Instagram은 백그라운드에서 실행됨 — check_analysis_job(job_id)를 사용하여 폴링

Python을 찾을 수 없음

python.org에서 Python 3.10+ 설치

기여

가이드라인은 CONTRIBUTING.md를 참조하세요.

라이선스

MIT — LICENSE 참조.

지원

유용하게 사용하셨다면 저장소에 별을 눌러주세요!

사우디아라비아 동부 주에서 ❤️를 담아 제작되었습니다.

العربية

خادم تحليل الفيديو بالذكاء الاصطناعي

خادم MCP لتحليل الفيديو باستخدام Google Gemini — احدث واقوى نموذج ذكاء اصطناعي متعدد الوسائط من جوجل.

المميزات

الاداة

الوصف

analyze_video

تحليل شامل للصوت والصورة مع دعم الاوامر المخصصة

get_transcript

استخراج النص المنطوق مع الطوابع الزمنية — يدعم +100 لغة

ask_about_video

اسال اي سؤال عن محتوى الفيديو

watch_and_analyze

استخراج خطوات الشروحات التقنية والاوامر والاكواد

execute_tutorial_steps

مراجعة وتنفيذ الخطوات المستخرجة بامان

المنصات المدعومة

المنصة

السرعة

يوتيوب

فوري — تحليل مباشر بدون تحميل

تيك توك

~8 ثواني — واجهة tikwm.com السريعة

انستاجرام

~10 ثواني — استخراج مباشر من الصفحة

التثبيت السريع

git clone https://github.com/u2n4/video-url-analyzer-mcp.git
cd video-url-analyzer-mcp
pip install -e .

الامان

الخادم محمي ضد:

  • SSRF — قائمة بيضاء للنطاقات المسموحة فقط

  • حقن الاوامر — حظر الاوامر الخطيرة + تنفيذ بدون shell

  • اختراق المسارات — حظر 25+ مسار حساس

  • حماية من الحمل الزائد — حد اقصى 10 مهام متزامنة

الحصول على مفتاح API

  1. اذهب الى Google AI Studio

  2. انشئ مفتاح API مجاني

  3. ضعه في ملف .env

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
1Releases (12mo)

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/u2n4/video-url-analyzer-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server