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 视频 URL 或视频 ID
    • lang (字符串, 可选, 默认: "en"): 字幕的语言代码（例如, 'ko', 'en'）

主要功能

• 支持多种视频 URL 格式
• 按语言检索字幕
• 响应中包含详细元数据

配置

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

错误处理

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

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

使用示例

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

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

安全注意事项

服务器：

• 验证所有输入参数
• 优雅地处理 YouTube API 错误
• 为字幕检索实现超时
• 提供详细的错误消息以便故障排除

许可证

本 MCP 服务器根据 MIT 许可证发布。详情请参见 LICENSE 文件。