MCP YouTube 대본 서버
YouTube 동영상의 대본을 검색할 수 있는 모델 컨텍스트 프로토콜 서버입니다. 이 서버는 간단한 인터페이스를 통해 동영상 대본에 직접 접근할 수 있도록 하여 콘텐츠 분석 및 처리에 이상적입니다.
목차
Related MCP server: YouTube Transcript Server
특징
✨ 주요 기능:
YouTube 동영상에서 대본 추출
여러 언어 지원
연속 모드 또는 단락 모드로 텍스트 서식 지정
비디오 제목 및 메타데이터 검색
자동 문단 분할
텍스트 정규화 및 HTML 엔터티 디코딩
강력한 오류 처리
타임스탬프 및 중복 감지
시작하기
필수 조건
Node.js 18 이상
설치
두 가지 설치 방법이 제공됩니다.
옵션 1: 수동 구성(프로덕션에 권장)
Claude Desktop 구성 파일을 생성하거나 편집합니다.
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%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 또는 IDlang(문자열, 선택 사항): 언어 코드(기본값: "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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.