YouTube Transcript Server

YouTube Transcript Server

一个 Model Context Protocol 服务，可从 YouTube 视频中获取转录文本。此服务通过简单的界面直接访问视频字幕。

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 YouTube Transcript Server：

npx -y @smithery/cli install @kimtaeyoon83/mcp-server-youtube-transcript --client claude

组件

工具

• get_transcript

  • 从 YouTube 视频中提取转录文本
  • 输入：
    • url（字符串，必填）：YouTube 视频 URL、Shorts URL 或视频 ID
    • lang（字符串，可选，默认值："en"）：转录文本的语言代码（例如，'ko'、'en'）。如果找不到请求的语言，将自动回退到可用语言。
    • include_timestamps（布尔值，可选，默认值：false）：在输出中包含时间戳（例如，'[0:05] text'）
    • strip_ads（布尔值，可选，默认值：true）：根据章节标记从转录文本中过滤赞助内容、广告和推广内容

• analyze_video（可选，需要 TwelveLabs API 密钥）

  • 使用 TwelveLabs Pegasus（一种视频理解模型）分析视频。与 get_transcript 不同，它会对屏幕上显示的内容进行推理，因此即使视频几乎没有或完全没有语音（如演示、游戏实况、辅助镜头、音乐视频），也能生成有用的摘要和回答。
  • 输入：
    • url（字符串，必填）：公开可访问的直接视频 URL（例如，.mp4/.mov/.webm 链接或预签名 URL）。TwelveLabs 会在服务端获取文件，因此 YouTube 观看页面 URL 无法使用——它提供的是 HTML，而非原始视频流。
    • prompt（字符串，可选）：给模型的指令或问题（例如，"Summarize this video in 3 sentences" 或 "What products are shown?"）。默认生成通用摘要。
    • model（字符串，可选，默认值："pegasus1.2"）：要使用的 Pegasus 模型（"pegasus1.2" 或 "pegasus1.5"）。
    • max_tokens（数字，可选，默认值：2048）：响应的最大 token 数。
  • 需要 TWELVELABS_API_KEY 环境变量。转录工具无需此密钥即可使用；视频分析完全由用户选择是否启用。可在 twelvelabs.io 免费获取密钥——免费套餐额度充足。

主要功能

• 支持多种视频 URL 格式（包括 YouTube Shorts）
• 按语言获取转录文本，并自动回退
• 可选添加时间戳，方便定位特定片段
• 内置广告/赞助内容过滤功能（默认启用）
• 获取转录文本时无需外部依赖
• 在响应中提供详细元数据

配置

如需在 Claude Desktop 中使用，请添加以下服务配置：

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
    }
  }
}

如需启用可选的 analyze_video 工具，请添加 TwelveLabs API 密钥：

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"],
      "env": {
        "TWELVELABS_API_KEY": "your-twelvelabs-api-key"
      }
    }
  }
}

通过工具安装

mcp-get 一个用于安装和管理 Model Context Protocol（MCP）服务的命令行工具。

npx @michaellatman/mcp-get@latest install @kimtaeyoon83/mcp-server-youtube-transcript

Awesome-mcp-servers

awesome-mcp-servers 一个精选的优秀 Model Context Protocol（MCP）服务列表。

开发

先决条件

• Node.js 18 或更高版本
• npm 或 yarn

配置

安装依赖：

npm install

构建服务：

npm run build

开发时启用自动重新构建：

npm run watch

测试

npm test

调试

由于 MCP 服务通过 stdio 通信，调试可能颇具挑战。我们建议在开发过程中使用 MCP Inspector：

npm run inspector

运行评估

evals 包会加载一个 MCP 客户端，然后运行 index.ts 文件，因此测试之间无需重新构建。可以在 npx 命令前添加环境变量来加载它们。完整文档请参阅此处。

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

错误处理

该服务针对常见情况实现了稳健的错误处理：

• 无效的视频 URL 或 ID
• 字幕不可用
• 语言可用性问题
• 网络错误

使用示例

1. 通过视频 URL 获取字幕：

await server.callTool("get_transcript", {
  url: "https://www.youtube.com/watch?v=VIDEO_ID",
  lang: "en"
});

2. 通过视频 ID 获取字幕：

await server.callTool("get_transcript", {
  url: "VIDEO_ID",
  lang: "ko"
});

3. 获取 YouTube Shorts 的字幕：

await server.callTool("get_transcript", {
  url: "https://www.youtube.com/shorts/VIDEO_ID"
});

4. 获取带时间戳的字幕：

await server.callTool("get_transcript", {
  url: "VIDEO_ID",
  include_timestamps: true
});

5. 获取未经广告过滤的原始字幕：

await server.callTool("get_transcript", {
  url: "VIDEO_ID",
  strip_ads: false
});

6. 如何在 Claude 桌面应用中提取 YouTube 字幕

chat: https://youtu.be/ODaHJzOyVCQ?si=aXkJgso96Deri0aB Extract subtitles

安全注意事项

该服务：

• 验证所有输入参数
• 妥善处理 YouTube API 错误
• 为字幕检索设置超时
• 提供详细的错误消息以便排查问题

许可证

此 MCP 服务采用 MIT 许可证。详情请参阅 LICENSE 文件。