YouTube 字幕服务器

一个 Model Context Protocol（MCP）服务器，用于从 YouTube 视频中检索字幕。该服务器提供通过简单界面直接访问视频字幕的功能。

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 YouTube 字幕服务器：

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

组件

工具

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

主要功能

• 支持多种视频链接格式（包括 YouTube Shorts）
• 支持特定语言字幕检索，并具有自动回退功能
• 可选时间戳，便于引用特定时刻
• 内置广告/赞助商过滤（默认启用）
• 字幕获取无需外部依赖
• 响应中包含详细元数据

配置

要在 Claude Desktop 中使用此服务器，请添加以下配置：

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

通过工具安装

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

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

优秀的 MCP 服务器

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

运行评估

评估包会加载一个 MCP 客户端，然后运行 index.ts 文件，因此无需在测试之间重新构建。你可以通过为 npx 命令添加前缀来加载环境变量。完整文档见此处。

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

错误处理

服务器针对常见场景实现了健壮的错误处理：

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

使用示例

1. 通过视频链接获取字幕：

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 Desktop 应用中提取 YouTube 字幕

chat: https://youtu.be/ODaHJzOyVCQ?si=aXkJgso96Deri0aB 提取字幕

安全注意事项

该服务器：

• 验证所有输入参数
• 优雅地处理 YouTube API 错误
• 为字幕检索实现超时机制
• 提供详细的错误消息以便故障排除

许可证

此 MCP 服务器基于 MIT 许可证授权。详见 LICENSE 文件。

mcp-server-youtube-transcript 快速上手指南

一个用于获取 YouTube 视频字幕的 Model Context Protocol 服务器。

环境准备

• Node.js: 18.0.0 或更高版本
• 包管理器: npm 或 yarn
• 运行环境: 支持 Claude Desktop

安装步骤

方式一：通过 Smithery 自动安装（推荐）

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

方式二：通过 mcp-get 安装

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

方式三：手动配置

在 Claude Desktop 配置文件中添加：

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

基本使用

工具：get_transcript

获取 YouTube 视频字幕，支持以下参数：

参数	类型	必填	默认值	说明
url	string	是	-	YouTube 视频链接、视频 ID 或 Shorts 链接
lang	string	否	"en"	语言代码（如 "en"、"ko"、"zh"）
include_timestamps	boolean	否	false	是否包含时间戳
strip_ads	boolean	否	true	是否过滤广告和赞助内容

使用示例

1. 通过视频链接获取字幕

chat: https://youtu.be/ODaHJzOyVCQ?si=aXkJgso96Deri0aB 提取字幕

2. 获取带时间戳的字幕

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

3. 获取指定语言的字幕

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

4. 获取 YouTube Shorts 字幕

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

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

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

本地开发

# 安装依赖
npm install

# 构建项目
npm run build

# 开发模式（自动重载）
npm run watch

# 运行测试
npm test