YouTube Transcript Extractor MCP 🎥

基本能力

产品定位

• 一个专门用于从 YouTube 视频中提取字幕/转录文本的 MCP 服务
• 主要面向 AI 助手开发者，用于增强 AI 处理视频内容的能力

核心功能

• 🎯 从任何公开的 YouTube 视频中提取字幕/转录文本
• 🔌 轻松与 Cursor 和 Claude Desktop 集成
• 🚀 使用 TypeScript 构建，确保类型安全
• 📦 简单的设置和部署流程
• 🛠️ 基于 Model Context Protocol 标准

适用场景

• AI 助手需要分析 YouTube 视频内容时
• 开发者需要将视频内容整合到 AI 工作流中
• 需要快速获取视频字幕进行内容分析

工具列表

• @modelcontextprotocol/sdk: 用于 MCP 实现的核心 SDK
• youtube-transcript: 用于实际从 YouTube 提取字幕的库
• TypeScript: 提供类型安全和更好的开发体验

常见问题解答

1. "Cannot find video ID" 错误
2. 确保 YouTube URL 完整且正确

3. 检查视频是否公开可访问

4. "No transcript available" 错误

5. 确认视频已启用字幕功能

6. 尝试其他视频以确认工具是否正常工作

7. 构建错误

8. 确保所有依赖已安装
9. 检查 Node.js 版本(应为 v16 或更高)

使用教程

使用依赖

• Node.js (v16 或更高版本)
• pnpm (推荐) 或 npm
• 要提取字幕的 YouTube 视频 URL

安装教程

1. 克隆仓库:

git clone https://github.com/yourusername/yt-mcp.git
cd yt-mcp

1. 安装依赖:

pnpm install

1. 构建项目:

pnpm run build

配置方法

对于 Cursor

1. 打开 Cursor 设置
2. 导航到 MCP → 添加新的 MCP 服务器
3. 使用以下设置配置:
4. 名称: youtube-transcript
5. 类型: command
6. 命令: node /absolute/path/to/yt-mcp/build/index.js

对于 Claude Desktop

将以下配置添加到 Claude Desktop 配置中:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "node",
      "args": ["/absolute/path/to/yt-mcp/build/index.js"]
    }
  }
}

调试方式

安装完成后，可以通过以下方式测试: 1. 确保服务已正确配置到 Cursor 或 Claude Desktop 2. 尝试提取一个已知有字幕的 YouTube 视频转录 3. 检查返回的转录文本是否完整准确 4. 如遇问题，查看终端或日志中的错误信息

许可证

该项目遵循 MIT 开源许可条款。