yt-description-mcp

🚀 YouTube 转录提取器 MCP 🎥

YouTube转录提取器MCP是一个基于模型上下文协议（MCP）构建的服务器，它允许AI助手直接从YouTube视频中提取字幕。该工具专为与Cursor和Claude Desktop集成而设计，能让AI分析并直接处理YouTube视频内容，极大提升了对视频内容的利用效率。

🚀 快速开始

本工具能让AI直接处理YouTube视频内容，以下为你介绍使用前的准备和操作步骤。

✨ 主要特性

• 🎯 可从任何公开的YouTube视频中提取字幕，方便获取视频文字信息。
• 🔌 能与Cursor和Claude Desktop轻松集成，拓展AI工具的视频处理能力。
• 🚀 使用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许可证。