一个TypeScript模型上下文协议服务器，可获取Claude Desktop、Cursor、Cline、Codex及其他兼容MCP客户端的YouTube文字记录。它设计用于本地npx，因此文字记录请求可从您自己的电脑发出，而非远程代理。

目录

• 特色
• 入门指南
• 先决条件
• 安装
• 使用情况
• 基本配置
• Docker
• 测试
• 故障排查与维护
• 工具
• 发展
• 贡献
• 许可证

特色

主要能力：

• 摘录YouTube视频文字稿
• 支持多种语言
• Android InnerTube 当前 YouTube 字幕回复的备选
• 兼容工具名称：get_transcripts 和 get_transcript
• 带有时间戳的转录输出，带有get_timed_transcript
• 视频元数据及可用的文字稿语言
• 采用连续或段落格式化文本
• 检索视频标题和元数据
• 自动段落分割
• 文本规范化与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",