Claudeデスクトップ、Cursor、Cline、CodexなどのMCP互換クライアントのYouTubeトランスクリプトを取得するTypeScriptモデルコンテキストプロトコルサーバー。 ローカル[npxのために設計されているので、トランスクリプトのリクエストは、リモートプロキシの代わりに自分のマシンから作られています。

コンテンツの表

• 特徴
• 始める
• 前提条件
• インストール
• 使用法
• 基本構成
• ドッカー
• テスト
• トラブルシューティングとメンテナンス
• ツール
• 開発
• 貢献
• ライセンス

##特徴

主な機能:

• YouTube動画からトランスクリプトを抽出する
• 多言語対応
• 現在のYouTubeのキャプション応答のためのAndroid内部Tubeフォールバック
• 対応ツール名:get_transcriptsと[get_transcript]
• [[[T3]でタイムスタンプされたトランスクリプト出力]
• ビデオメタデータと利用可能なトランスクリプト言語
• 連続または段落モードでテキストをフォーマットする
• ビデオタイトルとメタデータの取得
• 自動段落分割
• テキスト正規化とHTMLエンティティティエントデコーディング
• 強力なエラー処理
• タイムスタンプおよび重複の検出

はじめる

前提条件

• 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",