Claude Desktop, Cursor, Cline, Codex 및 기타 MCP 호환 클라이언트에 대한 YouTube 성적을 검색하는 TypeScript Model Context Protocol 서버. 로컬 npx]를 위해 설계되어 있습니다.

내용 표

• 특징
• 시작하기
• 필수
• 설치
• 사용
• 기본 설정
• 도커
• 테스트
• 문제 해결 및 유지 보수
• 도구
• 개발
• 기여
• 라이센스

특징

주요 기능:

• YouTube 동영상에서 성적표 추출
• 여러 언어 지원
• Android InnerTube는 현재 YouTube caption 응답에 대한 fallback
• 호환성 도구 이름 : get_transcripts 및 get_transcript
• get_timed_transcript로 타임탬프 성적표 출력
• 비디오 metadata 및 사용 가능한 성적 언어
• 연속 또는 단락 모드로 형식 텍스트
• 동영상 제목 및 메타데이터 검색
• 자동 단락 세그먼트
• 텍스트 정상화 및 HTML 엔터티 디코딩
• Robust 오류 처리
• 타임스탬프 및 오버랩 감지

시작하기

# 필수품

• Node.js 18 이상

설치

MCP YouTube Transcript Server

A TypeScript Model Context Protocol server that retrieves YouTube transcripts for Claude Desktop, Cursor, Cline, Codex, and other MCP-compatible clients. It is designed for local npx usage so transcript requests are made from your own machine instead of a remote proxy.

Table of Contents

• Features
• Getting Started
  • Prerequisites
  • Installation
• Usage
  • Basic Configuration
  • Docker
  • Testing
  • Troubleshooting and Maintenance
• Tools
• Development
• Contributing
• License

Features

Key capabilities:

• Extract transcripts from YouTube videos
• Support for multiple languages
• Android InnerTube fallback for current YouTube caption responses
• Compatible tool names: get_transcripts and get_transcript
• Timestamped transcript output with get_timed_transcript
• Video metadata and available transcript languages
• Format text with continuous or paragraph mode
• Retrieve video titles and metadata
• Automatic paragraph segmentation
• Text normalization and HTML entity decoding
• Robust error handling
• Timestamp and overlap detection

Getting Started

Prerequisites

• Node.js 18 or higher

Installation

Use a local npx configuration so transcript requests are sent from your own machine instead of a remote MCP proxy.

1. Create or edit the Claude Desktop configuration file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the following configuration:

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

Quick setup script for 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",