YouTube视频转录提取器

一个基于模型上下文协议(MCP)的服务,用于从YouTube视频中提取转录文本,支持与Cursor和Claude Desktop集成,使AI能够直接分析和处理YouTube视频内容。

  • by MalikElate
  • TypeScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 MalikElate/yt-description-mcp

使用说明

YouTube转录提取器MCP🎥

一个模型上下文协议(MCP)服务器,使AI助手能够从YouTube视频中提取转录本。该工具专为与Cursor和Claude Desktop集成而构建,允许人工智能直接分析和处理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

配置

对于光标

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

适用于克劳德桌面

将此配置添加到您的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"
});

技术细节

服务器是使用以下方式构建的:

局限性

  • 仅适用于公共YouTube视频
  • 视频必须启用字幕/字幕
  • 有些视频可能有自动生成的字幕,可能不是100%准确

故障排除

常见问题和解决方案:

  1. “找不到视频ID”错误

    • 确保YouTube URL完整且正确
    • 检查视频是否可公开访问
  2. “无可用成绩单”错误

    • 验证视频是否启用了字幕
    • 尝试其他视频以确认工具是否正常工作
  3. 构建错误

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

贡献

欢迎投稿!请随时提交拉取请求。对于重大更改,请先打开一个问题来讨论您想要更改的内容。

许可证

麻省理工学院