ytt-mcp：获取和处理YouTube视频字幕的服务器工具

ytt-mcp是一个开源的MCP（模型上下文协议）服务器工具，专门用于从YouTube视频中获取字幕并进行处理。它由cottongeeks团队开发，托管在GitHub上，旨在帮助用户通过简单命令或AI工具快速提取视频字幕，并支持进一步的内容分析和总结。用户可以通过Raycast等平台直接调用该工具，适合内容创作者、研究人员或需要视频内容的用户。项目代码开放，易于安装和扩展，适合开发者或技术爱好者使用。

功能列表

• 提取YouTube视频的自动生成字幕或用户上传字幕。
• 支持通过命令行或Raycast扩展调用字幕获取功能。
• 提供字幕内容总结功能，生成简洁的关键要点和主题分析。
• 兼容MCP协议，可与AI工具集成，增强字幕处理能力。
• 支持自定义提示词，允许用户根据需求处理字幕内容。
• 开源项目，允许用户贡献代码或定制功能。

使用帮助

安装流程

要使用ytt-mcp，首先需要确保你的系统环境满足基本要求。以下是详细的安装步骤：

1. 准备环境
   • 确保已安装Node.js（建议版本16或以上）。
   • 安装Python 3.8+，因为部分依赖可能需要Python支持。
   • 如果使用Raycast，需安装Raycast应用并启用MCP扩展。
   • 确保有Git工具用于克隆代码仓库。
2. 克隆项目代码
   打开终端，运行以下命令克隆ytt-mcp仓库：

   git clone https://github.com/cottongeeks/ytt-mcp.git
   

   进入项目目录：

   cd ytt-mcp
   

3. 安装依赖
   在项目目录中运行以下命令安装必要依赖：

   npm install
   

   如果项目需要Python依赖，运行：

   pip install -r requirements.txt
   

4. 配置MCP服务器
   在项目目录中找到配置文件（通常为config.json或类似文件）。根据提示设置YouTube API密钥（可选，用于增强字幕提取功能）。配置文件示例：

   {
   "mcpServers": {
   "ytt-mcp": {
   "command": "uvx",
   "args": ["ytt-mcp"]
   }
   }
   }
   

5. 启动服务器
   运行以下命令启动ytt-mcp服务器：

   npm start
   

   或者，如果使用Raycast，打开Raycast并运行Install Server命令，输入@youtube-transcript即可注册服务器。

6. 验证安装
   启动后，访问http://localhost:端口号（端口号在配置文件中指定，默认为3000），确认服务器正常运行。

使用方法

ytt-mcp的核心功能是提取YouTube视频字幕并进行处理。以下是具体操作步骤：

提取字幕

• 通过Raycast使用
  在Raycast中输入@youtube-transcript，然后粘贴YouTube视频URL（例如https://www.youtube.com/watch?v=视频ID）。Raycast会自动调用ytt-mcp服务器，提取字幕并显示。
  示例命令：

  @youtube-transcript fetch the Youtube transcript of the video: https://www.youtube.com/watch?v=aO1-6X_f74M
  

• 通过命令行使用
  在终端运行以下命令：

  uvx ytt-mcp --url https://www.youtube.com/watch?v=视频ID
  

  运行后，字幕将保存为文本文件，或直接在终端输出。

字幕内容总结

ytt-mcp支持通过自定义提示词生成字幕总结。例如，使用以下提示词：

@youtube-transcript fetch the Youtube transcript of the video: {clipboard | raw}
Comprehensively summarize the transcript with the following format:
"""
### Key Takeaways
- 关键点1
- 关键点2
- 关键点3
"""
### Theme Wise Breakdown
- 主题1：内容概述
- 主题2：内容概述
"""

将YouTube视频URL复制到剪贴板，然后在Raycast中运行上述提示词。ytt-mcp会提取字幕并生成结构化的总结，包含三个关键点和按主题划分的内容分析。

集成AI工具

ytt-mcp支持MCP协议，可以与AI工具（如Claude或Cursor）集成。用户可以通过MCP客户端调用ytt-mcp，执行复杂任务。例如：

• 在Cursor中配置MCP服务器URL为http://localhost:3000。
• 使用自然语言命令，如“提取视频字幕并总结关键点”，即可触发ytt-mcp处理。

自定义扩展

开发者可以修改ytt-mcp的源代码，添加新功能。例如，增加对其他视频平台的支持或优化字幕格式化逻辑。修改后，提交代码到GitHub仓库，参与社区开发。

注意事项

• 确保YouTube视频启用了自动字幕或上传了字幕，否则提取可能失败。
• Raycast扩展需要保持网络连接以访问MCP服务器。
• 如果使用YouTube API，需遵守API使用配额限制。

应用场景

1. 内容创作者
   内容创作者可以用ytt-mcp提取YouTube视频字幕，快速生成视频内容总结，用于制作社交媒体文案或博客文章。例如，提取教学视频字幕，整理成关键要点发布到微博。
2. 教育研究
   学生或研究人员可以提取学术讲座视频的字幕，生成结构化笔记，方便复习或引用。例如，整理一场TED演讲的主题和关键内容。
3. 多语言翻译
   字幕提取后，用户可以结合AI工具翻译字幕内容，生成多语言版本，适合跨国团队或多语言内容分发。
4. 自动化工作流
   开发者可以将ytt-mcp集成到自动化脚本中，批量处理多个视频字幕，用于数据分析或内容归档。

QA

1. ytt-mcp支持哪些视频平台？
   目前仅支持YouTube视频的字幕提取，未来可能通过社区贡献支持其他平台。
2. 需要YouTube API密钥吗？
   不强制要求，但配置API密钥可以提高字幕提取的稳定性和准确性。
3. 如何处理字幕提取失败？
   检查视频是否启用了字幕，确认网络连接正常，或尝试更新ytt-mcp到最新版本。
4. Raycast扩展如何安装？
   在Raycast中搜索MCP扩展，运行Install Server命令，输入@youtube-transcript并按提示配置。