YouTube 字幕服务器

一个模型上下文协议服务器，用于从 YouTube 视频中检索字幕。 该服务器通过一个简单的界面提供对视频字幕的直接访问。

<a href="https://glama.ai/mcp/servers/z429kk3te7"><img width="380" height="200" src="https://glama.ai/mcp/servers/z429kk3te7/badge" alt="mcp-server-youtube-transcript MCP server" /></a>

通过 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 一个用于安装和管理模型上下文协议 (MCP) 服务器的命令行工具。

npx @michaellatman/mcp-get@latest install @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 Inspector 进行开发：

npm run inspector

错误处理

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

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

使用示例

1. 通过视频 URL 获取字幕：

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

2. 通过视频 ID 获取字幕：

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

3. 如何在 Claude Desktop 应用程序中提取 YouTube 字幕

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

安全注意事项

服务器：

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

许可证

此 MCP 服务器已获得 MIT 许可证的许可。 有关详细信息，请参见 LICENSE 文件。