YouTube 转录服务器

一个支持从 YouTube 视频中获取转录的模型上下文协议（Model Context Protocol，MCP）服务器。该服务器通过简单的接口提供对视频字幕和 subtitle 的直接访问。

使用 Smithery 安装

通过 Smithery 自动安装 YouTube 转录服务器以供 Claude Desktop 使用：

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

组件

工具

• get_transcript
  • 提取 YouTube 视频的转录内容
  • 输入：
    • url（字符串，必填）：YouTube 视频 URL 或视频 ID
    • lang（字符串，可选，默认："en"）：转录语言代码（例如 'ko'、'en'）

主要功能

• 支持多种视频 URL 格式
• 按语言获取转录内容
• 响应中包含详细元数据

配置

与 Claude Desktop 一起使用时，添加以下服务器配置：

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

工具安装

mcp-get 是一个命令行工具，用于安装和管理模型上下文协议（MCP）服务器。

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

Awesome-mcp-servers

awesome-mcp-servers 是一个经过精选的 MCP 服务器列表。

开发

先决条件

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

设置

安装依赖项：

npm install

构建服务器：

npm run build

带有自动重建功能的开发：

npm run watch

测试

npm test

调试

由于 MCP 服务器通过标准输入输出进行通信，调试可能具有挑战性。我们推荐使用 MCP Inspector 进行开发：

npm run inspector

错误处理

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

• 无效的视频 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. 如何在 Claude Desktop 应用中提取 YouTube 字幕

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

安全注意事项

该服务器：

• 验证所有输入参数
• 处理 YouTube API 错误
• 实现转录获取的超时机制
• 保持网络通信的安全性

许可证

[在此处添加许可证信息]