YouTube 转录提取器 MCP 🎥

一个基于模型上下文协议（MCP）构建的服务器，允许AI助手直接从YouTube视频中提取字幕。此工具专为与Cursor和Claude Desktop集成而设计，使AI能够分析并直接处理YouTube视频内容。

功能特性

• 🎯 从任何公开的YouTube视频中提取字幕
• 🔌 与Cursor和Claude Desktop轻松集成
• 🚀 使用TypeScript实现类型安全
• 📦 简单的安装和部署流程
• 🛠️ 基于模型上下文协议构建

先决条件

• Node.js（v16或更高版本）
• pnpm（推荐）或npm
• 一个用于提取字幕的YouTube视频链接

安装

1. 克隆仓库：

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

2. 安装依赖项：

pnpm install

3. 构建项目：

pnpm run build

配置

对于Cursor

1. 打开Cursor设置
2. 进入MCP → 添加新的MCP服务器
3. 使用以下配置：
   • 名称：youtube-transcript
   • 类型：命令
   • 命令：node /绝对路径/to/yt-mcp/build/index.js

对于Claude Desktop

将以下配置添加到你的Claude Desktop配置文件中：

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "node",
      "args": ["/绝对路径/to/yt-mcp/build/index.js"]
    }
  }
}

使用方法

完成配置后，AI可以通过传递视频链接来提取字幕。示例：

// AI会使用此格式在内部调用
const transcript = await extractTranscript({
  input: "https://www.youtube.com/watch?v=VIDEO_ID"
});

技术细节

服务器使用以下技术构建：

• @modelcontextprotocol/sdk - 用于MCP实现
• youtube-transcript - 用于字幕提取
• TypeScript - 提供类型安全和更好的开发体验

局限性

• 只能处理公开的YouTube视频
• 视频必须启用了字幕功能
• 部分视频可能使用自动生成的字幕，准确性可能会有所折扣

常见问题修复

1. “无法找到视频ID”错误

   • 确保YouTube链接完整且正确
   • 检查视频是否公开可访问

2. “无字幕可用”错误

   • 验证视频是否启用了字幕功能
   • 尝试其他视频以确认工具正常工作

3. 构建错误

   • 确保所有依赖项已安装
   • 检查Node.js版本（应为v16或更高）

贡献

欢迎贡献！请随意提交Pull Request。对于重大更改，请先打开问题讨论您想要修改的内容。

许可证

MIT