YouTube Transcript Extractor 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

1. 安装依赖项：

pnpm install

1. 构建项目：

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视频中提取字幕。例如：

// The AI will use this format internally
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。对于重大更改，请先打开一个问题讨论您想要修改的内容。

许可证

MIT