金大哥 - youtube-transcript-server MCP 详情

article

README

🚀 YouTube 转录服务器

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

🚀 快速开始

使用 Smithery 安装

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

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

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

📚 详细文档

组件

工具

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

配置

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

{
  "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 服务器通过标准输入输出进行通信，调试可能具有挑战性。我们推荐使用 MCP Inspector 进行开发：

npm run inspector

错误处理

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

无效的视频 URL 或 ID
无法获取的转录内容
语言可用性问题
网络错误

安全注意事项

该服务器：

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

📄 许可证

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

youtube-transcript-server