YouTube 字幕服务器

这是一个模型上下文协议（MCP）服务器，能够从YouTube视频中检索字幕。该服务器通过简单的接口提供对视频字幕和字幕的直接访问。

<a href="https://glama.ai/mcp/servers/z429kk3te7"><img width="380" height="200" src="https://gips2.baidu.com/it/u=2307774328,3207798294&fm=3081&app=3081&f=PNG?w=760&h=400" alt="mcp-server-youtube-transcript MCP 服务器" /></a>

通过 Smithery 安装

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

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服务器通过标准I/O通信，调试可能会很困难。我们推荐使用MCP Inspector进行开发：

npm run inspector

运行评估

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

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

错误处理

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

• 无效的视频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 提取字幕

安全考虑

服务器：

• 验证所有输入参数
• 平稳处理YouTube API错误
• 实现字幕检索超时
• 提供详细的错误消息以帮助故障排除

许可证

此MCP服务器采用MIT许可证。详情见LICENSE文件。