JinDaGe - mcp-server-youtube-transcript MCP Details

article

README

🚀 YouTube 转录服务器

一个模型上下文协议（Model Context Protocol）服务器，用于从 YouTube 视频中获取转录文件。借助该服务器提供的简单接口，你可以直接访问视频字幕和 subtitles。

🚀 快速开始

通过 Smithery 安装

要通过 Smithery 自动安装 YouTube 转录服务器以供 Claude 桌面版使用，可执行以下命令：

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

✨ 主要特性

支持多种视频 URL 格式。
提供语言特定的转录文件检索。
响应中包含详细的元数据信息。

📦 安装指南

工具安装

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

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

💻 使用示例

基础用法

通过视频 URL 获取转录文件：

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

通过视频 ID 获取转录文件：

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

如何在 Claude 桌面应用程序中提取 YouTube 字幕

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

📚 详细文档

组件

工具

get_transcript
- 功能：提取 YouTube 视频的转录文件。
- 输入：
  - url (字符串，必需)：YouTube 视频 URL 或视频 ID。
  - lang (字符串，可选，默认值："en")：转录语言代码（例如 'ko'、'en'）。

配置

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

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": ["-y", "@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 服务器通过 stdio 进行通信，调试可能会比较困难。我们推荐使用 MCP 检查器进行开发：

npm run inspector

错误处理

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

无效的视频 URL 或 ID。
无法访问的转录文件。
语言可用性问题。
网络错误。

📄 许可证

项目仓库：mcp-server-youtube-transcript
许可证：MIT License

通过此服务器，您可以轻松地从 YouTube 视频中获取转录文件，并与模型上下文协议（MCP）系统集成。

mcp-server-youtube-transcript