YouTube Transcript Server

基本能力

产品定位

YouTube Transcript Server 是一个专门用于从 YouTube 视频中提取字幕和字幕文本的服务，旨在为开发者和用户提供便捷的视频字幕访问功能。

核心功能

• 支持多种 YouTube 视频 URL 格式
• 支持语言特定的字幕检索（默认英语，可选其他语言如韩语）
• 提供详细的响应元数据
• 强大的错误处理机制，包括无效视频 URL/ID、不可用字幕、语言可用性问题和网络错误

适用场景

• 在 Claude Desktop 应用中提取 YouTube 视频字幕
• 需要获取 YouTube 视频字幕的开发项目
• 多语言字幕检索和分析

工具列表

• get_transcript:
• 功能：从 YouTube 视频中提取字幕
• 输入参数：
  • url (字符串, 必需): YouTube 视频 URL 或视频 ID
  • lang (字符串, 可选, 默认: "en"): 字幕语言代码（如 'ko', 'en'）

常见问题解答

• 如何处理无效的视频 URL 或 ID？服务会进行参数验证并返回错误信息
• 如果请求的字幕不可用怎么办？服务会返回详细的错误消息
• 是否支持自动重试？服务实现了超时机制但未提及自动重试

使用教程

使用依赖

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

安装教程

通过 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

手动安装

1. 安装依赖

npm install

1. 构建服务器

npm run build

调试方式

1. 开发时自动重建

npm run watch

1. 运行测试

npm test

1. 使用 MCP Inspector 进行调试

npm run inspector

配置示例

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

使用示例

1. 通过视频 URL 获取字幕

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

1. 通过视频 ID 获取字幕

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

1. 在 Claude Desktop 应用中提取字幕

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

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。