youtube-summarize

YouTube 동영상 자막을 가져오고 선택적으로 요약하는 MCP 서버입니다.

기능

• 자막 가져오기: 다양한 형식(텍스트, JSON, SRT, WebVTT, pretty-print) 지원

• 동영상 메타데이터 — 제목, 설명, 채널, 업로드 날짜, 재생 시간, 조회수, 챕터 (yt-dlp 사용)

• 선택적 타임스탬프 — 일반 텍스트 자막에 포함 가능

• 동영상 요약 — LLM이 작업을 수행하기 전에 사람이 검토할 수 있도록 프롬프트가 명확하게 구분된 자막 반환

• 재생목록 동영상 나열 — 정렬 옵션을 포함하여 공개 재생목록을 빠르게 열거

• 사용 가능한 언어 나열 — 동영상 자막에 대해 지원되는 언어 확인

• 유연한 URL 파싱 — 전체 YouTube URL(youtube.com/watch?v=, youtu.be/, youtube.com/embed/, youtube.com/shorts/) 또는 동영상 ID만 입력 가능

• 다국어 지원 — 우선순위에 따라 특정 언어로 자막 요청 가능

Related MCP server: ytt-mcp

도구

get_transcript

YouTube 동영상의 자막을 가져옵니다. 기본적으로 응답 앞에 [METADATA] 블록(제목, 채널, 게시일, 재생 시간, 조회수, 설명)이 붙습니다. 자막만 출력하려면 include_metadata=false를 전달하세요.

summarize_transcript

자막을 가져와 요약 지침과 함께 반환합니다. 응답은 명확하게 레이블이 지정된 섹션([INSTRUCTIONS], [PROMPT_SOURCE], [VIDEO], [METADATA], [TRANSCRIPT])으로 구성되어 있어, LLM이 작업을 수행하기 전에 사람이 프롬프트를 검토할 수 있습니다.

get_video_metadata

YouTube 동영상의 메타데이터(제목, 설명, 채널, 업로드 날짜, 재생 시간, 조회수, 태그, 챕터 등)를 가져옵니다. yt-dlp 기반입니다.

list_playlist_videos

YouTube 재생목록의 동영상 목록(제목, ID, 채널, 재생 시간, 조회수, URL)을 나열합니다. 대규모 재생목록에서도 빠르게 호출할 수 있도록 동영상별 메타데이터는 간소화되어 있습니다. 자세한 내용은 특정 동영상 ID로 get_video_metadata를 호출하세요.

list_transcripts

동영상에 대해 사용 가능한 자막 언어 목록을 가져옵니다.

설치

빠른 시작 (권장)

uvx youtube-summarize

Claude Desktop

claude_desktop_config.json에 추가하세요:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "youtube-summarize": {
      "command": "uvx",
      "args": ["youtube-summarize"]
    }
  }
}

Claude Code

claude mcp add youtube-summarize -- uvx youtube-summarize

기타 MCP 클라이언트

stdio를 통해 서버를 실행하세요:

uvx youtube-summarize

사전 요구 사항

• Python 3.13+

• uv 패키지 관리자

개발

# Install dependencies
uv sync

# Launch the MCP inspector (web UI for testing tools)
uv run mcp dev main.py

라이선스

MIT

mcp-name: io.github.zlatkoc/youtube-summarize