YouTube 字幕服务器

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

通过 Smithery 安装

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

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

组件

工具

get_transcript
- 从 YouTube 视频中提取字幕
- 输入参数：
  - url（字符串，必填）：YouTube 视频链接或视频 ID
  - lang（字符串，可选，默认为 "en"）：字幕的语言代码（例如 'ko'、'en'）

主要功能

支持多种视频链接格式
支持按语言提取字幕
响应中包含详细的元数据

配置

要在 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

Awesome-mcp-servers

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

运行评估

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

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

错误处理

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

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

使用示例

通过视频链接获取字幕：

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 字幕

聊天：https://youtu.be/ODaHJzOyVCQ?si=aXkJgso96Deri0aB 提取字幕

安全考虑

该服务器：

验证所有输入参数
优雅地处理 YouTube API 错误
为字幕检索设置超时
提供详细的错误消息以帮助排查问题

许可证

此 MCP 服务器根据 MIT 许可证授权。详情请参阅 LICENSE 文件。