YouTube Transcript MCP Server

YouTube 영상의 트랜스크립트를 가져오는 MCP (Model Context Protocol) 서버입니다. Claude와 같은 AI 모델에서 YouTube 영상의 자막 데이터를 쉽게 활용할 수 있도록 해줍니다.

기능

YouTube 영상 URL에서 트랜스크립트 추출
다국어 트랜스크립트 지원 (한국어, 영어 등)
자동 생성 및 수동 생성 자막 모두 지원
사용 가능한 트랜스크립트 목록 조회

설치

저장소 클론
git clone <repository-url> cd youtube_transcript_mcp
가상환경 생성 및 활성화
python3 -m venv venv source venv/bin/activate # Linux/Mac # 또는 Windows의 경우: venv\Scripts\activate
의존성 설치
pip install -r requirements.txt

Claude Desktop 설정

Claude Desktop에서 이 MCP 서버를 사용하려면 Claude 설정 파일을 수정해야 합니다.

macOS

Claude Desktop 설정 파일 위치: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Claude Desktop 설정 파일 위치: %APPDATA%\Claude\claude_desktop_config.json

설정 파일에 다음 내용을 추가하세요:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "/path/to/your/youtube_transcript_mcp/venv/bin/python",
      "args": ["/path/to/your/youtube_transcript_mcp/youtube_transcript_mcp_server.py"],
      "env": {}
    }
  }
}

중요: /path/to/your/youtube_transcript_mcp를 실제 프로젝트 경로로 변경해주세요.

사용 방법

Claude Desktop에서 설정이 완료되면 다음과 같이 사용할 수 있습니다:

트랜스크립트 가져오기

이 YouTube 영상의 트랜스크립트를 가져와줘: https://www.youtube.com/watch?v=VIDEO_ID

특정 언어로 트랜스크립트 가져오기

이 영상의 영어 트랜스크립트를 가져와줘: https://www.youtube.com/watch?v=VIDEO_ID

사용 가능한 트랜스크립트 목록 조회

이 영상에서 사용 가능한 트랜스크립트 목록을 보여줘: https://www.youtube.com/watch?v=VIDEO_ID

지원되는 URL 형식

https://www.youtube.com/watch?v=VIDEO_ID
https://youtu.be/VIDEO_ID
VIDEO_ID (11자리 비디오 ID만)

지원되는 언어

한국어 (ko) - 기본값
영어 (en)
기타 YouTube에서 지원하는 모든 언어

서버는 요청된 언어가 없을 경우 자동으로 한국어 → 영어 → 자동 생성 자막 순으로 시도합니다.

API 도구

이 MCP 서버는 다음 두 가지 도구를 제공합니다:

1. get_youtube_transcript

설명: YouTube 영상의 트랜스크립트를 가져옵니다
매개변수:
- url (필수): YouTube 영상 URL
- language (선택, 기본값: "ko"): 언어 코드

2. list_available_transcripts

설명: 사용 가능한 트랜스크립트 목록을 가져옵니다
매개변수:
- url (필수): YouTube 영상 URL

문제 해결

설정이 적용되지 않는 경우

Claude Desktop을 완전히 종료하고 다시 시작
설정 파일의 경로가 올바른지 확인
가상환경이 활성화되어 있는지 확인

트랜스크립트를 찾을 수 없는 경우

해당 영상에 자막이 없을 수 있습니다
비공개 영상이거나 접근이 제한된 영상일 수 있습니다
list_available_transcripts 도구를 사용해 사용 가능한 언어를 확인해보세요

의존성

mcp>=0.8.0: Model Context Protocol 라이브러리
youtube-transcript-api>=0.6.0: YouTube 트랜스크립트 API
asyncio: 비동기 처리

라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables AI models like Claude to easily access and utilize subtitle data from YouTube videos by extracting transcripts from video URLs with support for multiple languages.

Related MCP Servers

YouTube MCP Server
anaisbetts
-
security
A
license
-
quality
Uses yt-dlp to download subtitles from YouTube and connects it to claude.ai via Model Context Protocol.
Last updated -
1
826
410
JavaScript
MIT License
YouTube Integration
highlight-ing
-
security
F
license
-
quality
Enables extraction of transcript text from YouTube videos by providing the video URL, supporting standard, shortened, and embed URL formats.
Last updated -
4
1
JavaScript
YouTube Transcript Server
williamvd4
-
security
A
license
-
quality
A Model Context Protocol server that enables retrieval of transcripts from YouTube videos with language-specific support.
Last updated -
816
MIT License
YouTube MCP Server
icraft2170
-
security
F
license
-
quality
Enables AI language models to interact with YouTube content through a standardized interface, providing tools for retrieving video information, transcripts, channel analytics, and trend analysis.
Last updated -
4,423
41
JavaScript

View all related MCP servers

YouTube Transcript MCP Server