YouTube Transcript Extractor MCP

YouTube 대본 추출기 MCP 🎥

AI 비서가 YouTube 동영상에서 대본을 추출할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. Cursor 및 Claude Desktop과 통합되도록 설계된 이 도구를 통해 AI는 YouTube 동영상 콘텐츠를 직접 분석하고 작업할 수 있습니다.

특징

• 🎯 모든 공개 YouTube 비디오에서 대본 추출
• 🔌 Cursor 및 Claude Desktop과의 간편한 통합
• 🚀 유형 안전을 위해 TypeScript로 구축됨
• 📦 간단한 설정 및 배포
• 🛠️ 모델 컨텍스트 프로토콜 기반

필수 조건

• Node.js(v16 이상)
• pnpm(권장) 또는 npm
• YouTube 비디오 URL을 추출하여 대본을 추출합니다.

설치

1. 저장소를 복제합니다.

지엑스피1

2. 종속성 설치:

3. 프로젝트를 빌드하세요:

구성

커서용

1. 커서 설정 열기
2. MCP로 이동 → 새 MCP 서버 추가
3. 다음 설정으로 구성하세요.
   • 이름: youtube-transcript
   • 유형: command
   • 명령어: node /absolute/path/to/yt-mcp/build/index.js

클로드 데스크탑용

Claude Desktop 구성에 다음 구성을 추가하세요.

용법

설정이 완료되면 AI는 비디오 URL로 도구를 호출하여 YouTube 비디오에서 대본을 추출할 수 있습니다. 예:

기술적 세부 사항

서버는 다음을 사용하여 구축되었습니다.

• @modelcontextprotocol/sdk - MCP 구현용
• youtube-transcript - 대본 추출용
• TypeScript - 유형 안전성 및 더 나은 개발 경험을 위해

제한 사항

• 공개 YouTube 동영상에서만 작동합니다.
• 비디오에는 캡션/자막이 활성화되어 있어야 합니다.
• 일부 비디오에는 100% 정확하지 않을 수 있는 자동 생성된 자막이 있을 수 있습니다.

문제 해결

일반적인 문제 및 해결책:

1. "비디오 ID를 찾을 수 없습니다" 오류
   • YouTube URL이 완전하고 정확한지 확인하세요.
   • 영상이 공개적으로 접근 가능한지 확인하세요
2. "사용 가능한 대본이 없습니다" 오류
   • 비디오에 자막이 활성화되어 있는지 확인하세요
   • 도구가 작동하는지 확인하려면 다른 비디오를 시도하세요.
3. 빌드 오류
   • 모든 종속성이 설치되었는지 확인하세요
   • Node.js 버전을 확인하세요(v16 이상이어야 함)

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요. 주요 변경 사항의 경우, 먼저 이슈를 열어 변경 사항을 논의해 주세요.

특허

MIT