MCP YouTube Transcript Server

基本能力

产品定位

MCP YouTube Transcript Server 是一个专门用于从YouTube视频中提取字幕文本的服务，适用于内容分析、视频处理等场景。

核心功能

• 从YouTube视频中提取字幕
• 支持多种语言
• 提供连续或段落模式的文本格式化
• 获取视频标题和元数据
• 自动段落分割
• 文本标准化和HTML实体解码
• 强大的错误处理机制
• 时间戳和重叠检测

适用场景

• 视频内容分析
• 多语言字幕处理
• 视频内容摘要生成
• 视频内容翻译

工具列表

• get_transcripts: 从YouTube视频中提取字幕，支持多种语言和段落模式。

常见问题解答

• 如何检查日志？ bash tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
• 如何清理npx缓存？ bash rm -rf ~/.npm/_npx

使用教程

使用依赖

• Node.js 18或更高版本

安装教程

选项1: 手动配置（推荐用于生产环境）

1. 创建或编辑Claude Desktop配置文件：
2. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

3. Windows: %APPDATA%\Claude\claude_desktop_config.json

4. 添加以下配置：

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

快速设置脚本（macOS）：

mkdir -p ~/Library/Application\ Support/Claude
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

调试方式

使用Claude App测试

1. 安装后重启Claude应用
2. 使用以下命令测试： plaintext https://www.youtube.com/watch?v=AJpK3YTTKZ4 Summarize this video

使用MCP Inspector测试

git clone https://github.com/sinco-lab/mcp-youtube-transcript.git
cd mcp-youtube-transcript
npm install
npm run build
npx @modelcontextprotocol/inspector node "dist/index.js"

访问http://localhost:5173并尝试以下命令： 1. 列出工具: clink List Tools 2. 测试get_transcripts: - url: "https://www.youtube.com/watch?v=AJpK3YTTKZ4" - lang: "en" (可选) - enableParagraphs: false (可选)

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。