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 @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 App 中提取 YouTube 字幕

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

安全注意事项

服务器：

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

许可证

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