综合介绍

ytt-mcp 是一个专门用来获取YouTube视频文本内容的MCP（Meta-prompting Client Protocol）服务器。它的核心功能非常直接，就是根据用户提供的YouTube视频链接，提取出视频的完整字幕或文本记录。这个工具可以作为一个独立的后台服务运行。用户可以通过支持MCP协议的客户端应用，比如Raycast或者Claude Desktop，来调用它的功能。ytt-mcp 让用户能够绕过手动查找和复制视频字幕的繁琐步骤，将视频内容直接转化为文字。这些文字可以用于后续的总结、分析或存档，有效地提升了从视频中获取信息的效率。对于需要快速消化大量视频内容的用户来说，这个工具提供了一个自动化、可编程的解决方案。

功能列表

• 提取视频文本: 自动获取指定YouTube视频的完整文本记录。
• MCP服务: 作为一个标准的MCP服务器运行，可以被兼容的客户端发现和调用。
• 集成Raycast: 支持在Raycast中作为插件安装和使用，可以通过指令直接调用。
• 集成Claude Desktop: 支持配置到Claude Desktop应用中，让AI模型可以直接利用该工具获取视频信息。
• 命令行运行: 支持使用uvx等命令行工具直接启动服务，方便开发者调试和使用。
• 简化信息处理: 能够配合大型语言模型（如Claude）或自动化工具（如Raycast的AI Command）使用，实现对视频内容的自动摘要、分析和整理。

使用帮助

ytt-mcp 是一个轻量级的服务，安装和使用流程非常简单，主要依赖Python环境和uv包管理工具。下面将详细介绍如何在不同平台下安装和使用它。

基础安装与运行

安装和运行 ytt-mcp 最便捷的方式是使用 uv，它是一个高效的Python包安装和管理工具。

1. 安装 uv: 如果你的电脑还未安装uv，请先根据其官方指引进行安装。
2. 运行服务: 打开你的终端（Terminal），执行以下命令即可启动ytt-mcp服务：

   uvx ytt-mcp
   ```    该命令会自动处理依赖并运行服务。服务启动后，它会在后台等待客户端的调用。
   

开发与测试

如果你是开发者，想要对这个工具进行调试或测试，可以使用MCP Inspector。

1. 启动开发服务器: 在项目的根目录中，通过终端执行以下命令：

   uv run fastmcp dev ytt_mcp.py
   

2. 访问测试页面: 该命令会启动一个本地开发服务器，并生成一个 localhost 地址。你可以将此地址粘贴到浏览器中打开，页面上会提供一个简单的界面，让你能够直接测试服务的功能。

在Raycast中使用

Raycast用户可以非常方便地将ytt-mcp集成为一个效率工具。

1. 安装服务: 打开Raycast，找到其内置的MCP扩展，并选择 Install Server 命令。根据提示完成安装。
2. 调用服务: 安装成功后，你可以在Raycast的任意输入框中通过 @youtube-transcript 来唤起这个服务。
3. 配合AI命令使用: ytt-mcp 最大的优势是与Raycast的AI命令结合，实现自动化工作流。例如，你可以创建一个AI命令，让它自动获取剪贴板中的YouTube链接，提取文本内容，然后进行总结。

   下面是一个具体的AI命令提示（Prompt）示例：

   @youtube-transcript fetch the Youtube transcript of the video: {clipboard | raw}

   Comprehensively summarize the transcript with the following format:

   """

   Key Takeaways

   • <EXACTLY three bullet points with the key takeaways, keep the bullet points as short as possible>

   """

   Theme Wise Breakdown

   • 操作流程: 复制一个YouTube视频链接，然后运行这个AI命令。Raycast会自动调用ytt-mcp获取视频文本，并将其交给AI模型，最后按照你设定的格式输出摘要。

在Claude Desktop中使用

如果你使用Claude Desktop客户端，也可以将ytt-mcp添加为其可调用的工具。

1. 编辑配置文件: 在Claude Desktop的 Settings → Developer 菜单中，点击 Edit Config。这会打开一个名为 claude-desktop-config.json 的配置文件。
2. 添加服务配置: 在该JSON文件中，找到 mcpServers 字段，并添加以下配置信息：

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

   确保将其余已有的配置保留。

3. 重启并使用: 保存文件并重启Claude Desktop。之后，你就可以在和Claude的对话中，让它使用ytt-mcp工具来获取YouTube视频的文本内容了。

应用场景

1. 快速学习和研究当需要研究一个新课题时，YouTube上常有大量的教程和讲座视频。通过ytt-mcp，研究人员可以快速将这些视频内容转化为文字，便于快速阅读、搜索关键词和存档，而无需花费数小时观看视频。
2. 内容创作和分析媒体工作者或内容创作者可以利用此工具提取热门视频、新闻发布会或采访的文本，用于分析、引用或二次创作，极大地提高了素材处理的效率。
3. 会议和讲座纪要对于未能参加的线上会议或网络讲座，如果其录播视频发布在YouTube上，可以使用ytt-mcp获取完整的发言稿，方便回顾和整理会议要点。
4. 语言学习语言学习者可以提取外语视频的字幕文本，导入到学习工具中进行精读，查看生词和语法结构，是一种高效的沉浸式学习辅助手段。

QA

1. 这个工具是做什么的？ytt-mcp是一个MCP（Meta-prompting Client Protocol）服务器，它的核心功能是接收一个YouTube视频链接，然后返回该视频的完整文本文稿（transcript）。
2. 使用ytt-mcp需要安装什么前提软件？最主要的前提是安装uv，这是一个Python包管理工具。通过uv可以非常方便地一键运行ytt-mcp服务。当然，你的系统需要有Python环境。
3. 我可以在哪些软件里使用ytt-mcp？目前官方文档明确支持两种客户端：Raycast和Claude Desktop。你需要在这两个软件中进行简单的配置，就可以将它作为一个扩展功能来调用。
4. 这个工具是免费的吗？是的，ytt-mcp是一个在GitHub上开源的项目，遵循MIT许可证，任何人都可以免费使用和修改。
5. 如果一个YouTube视频没有提供字幕，这个工具还能用吗？这个工具依赖YouTube视频本身提供的字幕或自动生成的文本记录。如果一个视频完全没有这些信息，那么ytt-mcp将无法提取出有效的文本内容。