README.md•3.79 kB
# YouTube Transcript MCP Server
YouTube 영상의 트랜스크립트를 가져오는 MCP (Model Context Protocol) 서버입니다. Claude와 같은 AI 모델에서 YouTube 영상의 자막 데이터를 쉽게 활용할 수 있도록 해줍니다.
## 기능
- YouTube 영상 URL에서 트랜스크립트 추출
- 다국어 트랜스크립트 지원 (한국어, 영어 등)
- 자동 생성 및 수동 생성 자막 모두 지원
- 사용 가능한 트랜스크립트 목록 조회
## 설치
1. **저장소 클론**
```bash
git clone <repository-url>
cd youtube_transcript_mcp
```
2. **가상환경 생성 및 활성화**
```bash
python3 -m venv venv
source venv/bin/activate # Linux/Mac
# 또는 Windows의 경우: venv\Scripts\activate
```
3. **의존성 설치**
```bash
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`
설정 파일에 다음 내용을 추가하세요:
```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
## 문제 해결
### 설정이 적용되지 않는 경우
1. Claude Desktop을 완전히 종료하고 다시 시작
2. 설정 파일의 경로가 올바른지 확인
3. 가상환경이 활성화되어 있는지 확인
### 트랜스크립트를 찾을 수 없는 경우
- 해당 영상에 자막이 없을 수 있습니다
- 비공개 영상이거나 접근이 제한된 영상일 수 있습니다
- `list_available_transcripts` 도구를 사용해 사용 가능한 언어를 확인해보세요
## 의존성
- `mcp>=0.8.0`: Model Context Protocol 라이브러리
- `youtube-transcript-api>=0.6.0`: YouTube 트랜스크립트 API
- `asyncio`: 비동기 처리
## 라이선스
이 프로젝트는 MIT 라이선스 하에 배포됩니다.