YouTube 视频字幕提取器 MCP 🎥

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

功能

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

前提条件

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

安装

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
   • 类型: command
   • 命令: 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"]
    }
  }
}

用法

配置完成后，AI 可以通过使用视频 URL 调用该工具来提取 YouTube 视频的字幕。 示例:

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

技术细节

该服务器使用以下技术构建:

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

局限性

• 仅适用于公开的 YouTube 视频
• 视频必须启用字幕
• 某些视频可能具有自动生成的字幕，这些字幕可能不是 100% 准确

故障排除

常见问题和解决方案:

1. "无法找到视频 ID" 错误

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

2. "没有可用的字幕" 错误

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

3. 构建错误

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

贡献

欢迎贡献! 请随时提交 Pull Request。 对于重大更改，请先打开一个 issue 讨论您想要更改的内容。

许可证

MIT