YouTube Transcript Server

一个能够从YouTube视频中获取字幕的Model Context Protocol服务器。该服务器通过简洁的界面提供直接访问视频字幕和字幕的功能。

通过Smithery安装

要自动通过Smithery为Claude Desktop安装YouTube Transcript Server：

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

运行evals

evals包加载一个mcp客户端，然后运行index.ts文件，因此无需在测试之间重建。您可以通过在npx命令前缀中加载环境变量。完整文档可在此处找到https://www.mcpevals.io/docs。

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

错误处理

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

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

使用示例

通过视频URL获取字幕：

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

chat: https://youtu.be/ODaHJzOyVCQ?si=aXkJgso96Deri0aB 提取字幕

安全注意事项

服务器：

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

许可证

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

kimtaeyoon83/mcp-server-youtube-transcript

星标增长

证据时间轴