mcp-youtube-대본

MCP YouTube 대본 서버

YouTube 동영상의 대본을 검색할 수 있는 모델 컨텍스트 프로토콜 서버입니다. 이 서버는 간단한 인터페이스를 통해 동영상 대본에 직접 접근할 수 있도록 하여 콘텐츠 분석 및 처리에 이상적입니다.

특징

✨ 주요 기능:

YouTube 동영상에서 대본 추출
여러 언어 지원
연속 모드 또는 단락 모드로 텍스트 서식 지정
비디오 제목 및 메타데이터 검색
자동 문단 분할
텍스트 정규화 및 HTML 엔터티 디코딩
강력한 오류 처리
타임스탬프 및 중복 감지

시작하기

필수 조건

Node.js 18 이상

설치

두 가지 설치 방법이 제공됩니다.

옵션 1: 수동 구성(프로덕션에 권장)

Claude Desktop 구성 파일을 생성하거나 편집합니다.
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
다음 구성을 추가합니다.

지엑스피1

macOS용 빠른 설정 스크립트:

# Create directory if it doesn't exist
mkdir -p ~/Library/Application\ Support/Claude

# Create or update config file
cat > ~/Library/Application\ Support/Claude/claude_desktop_config.json << 'EOL'
{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": [
        "-y",
        "@sinco-lab/mcp-youtube-transcript"
      ]
    }
  }
}
EOL

옵션 2: Smithery 경유(개발 전용)

npx -y @smithery/cli install @sinco-lab/mcp-youtube-transcript --client claude

⚠️ 참고 : 이 방법은 Smithery의 프록시 서비스에 의존하므로 프로덕션 용도로는 권장되지 않습니다.

용법

기본 구성

Claude Desktop/Cursor/cline과 함께 사용하려면 구성이 다음과 일치하는지 확인하세요.

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": ["-y", "@sinco-lab/mcp-youtube-transcript"]
    }
  }
}

테스트

클로드 앱으로

설치 후 Claude 앱을 다시 시작하세요
간단한 명령으로 테스트해 보세요:
https://www.youtube.com/watch?v=AJpK3YTTKZ4 Summarize this video

출력 예:

MCP 검사관과 함께

# Clone and setup
git clone https://github.com/sinco-lab/mcp-youtube-transcript.git
cd mcp-youtube-transcript
npm install
npm run build

# Launch inspector
npx @modelcontextprotocol/inspector node "dist/index.js"

# Access http://localhost:6274 and try these commands:
# 1. List Tools: clink `List Tools`
# 2. Test get_transcripts with:
#    url: "https://www.youtube.com/watch?v=AJpK3YTTKZ4"
#    lang: "en" (optional)
#    enableParagraphs: false (optional)

문제 해결 및 유지 관리

클로드 로그 확인

Claude의 로그를 모니터링하려면 다음 명령을 사용할 수 있습니다.

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

이렇게 하면 로그 파일의 마지막 20줄이 표시되고, 새로운 항목이 추가되면 계속해서 표시됩니다.

참고 : Claude 앱은 MCP 서버 로그 파일에 자동으로 mcp-server- 를 붙입니다. 예를 들어, 저희 서버 로그는 mcp-server-youtube-transcript.log 에 기록됩니다.

`npx` 캐시 정리

npx 캐시와 관련된 문제가 발생하면 다음을 사용하여 수동으로 캐시를 정리할 수 있습니다.

rm -rf ~/.npm/_npx

이렇게 하면 캐시된 패키지가 제거되고 처음부터 다시 시작할 수 있습니다.

API 참조

성적증명서 받기

YouTube 동영상에서 대본을 가져옵니다.

매개변수:

url (문자열, 필수): YouTube 비디오 URL 또는 ID
lang (문자열, 선택 사항): 언어 코드(기본값: "en")
enableParagraphs (부울, 선택 사항): 문단 모드 활성화(기본값: false)

응답 형식:

{
  "content": [{
    "type": "text",
    "text": "Video title and transcript content",
    "metadata": {
      "videoId": "video_id",
      "title": "video_title",
      "language": "transcript_language",
      "timestamp": "processing_time",
      "charCount": "character_count",
      "transcriptCount": "number_of_transcripts",
      "totalDuration": "total_duration",
      "paragraphsEnabled": "paragraph_mode_status"
    }
  }]
}

개발

프로젝트 구조

├── src/
│ ├── index.ts            # Server entry point
│ ├── youtube.ts          # YouTube transcript fetching logic
├── dist/                 # Compiled output
└── package.json

주요 구성 요소

YouTubeTranscriptFetcher : 핵심 대본 가져오기 기능
YouTubeUtils : 텍스트 처리 및 유틸리티

특징 및 역량

오류 처리:
- 잘못된 URL/ID
- 사용할 수 없는 대본
- 언어 사용 가능 여부
- 네트워크 오류
- 속도 제한
텍스트 처리:
- HTML 엔티티 디코딩
- 구두점 정규화
- 공간 정규화
- 스마트 문단 감지

기여하다

여러분의 참여를 환영합니다! 이슈를 제출하거나 풀 리퀘스트를 보내주세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

mcp-youtube-transcript