YouTube 字幕服务器
这是一个模型上下文协议 (MCP) 服务器,它能够从 YouTube 视频中检索字幕或转录。该服务器通过一个简单的接口提供对视频字幕的直接访问。
通过 Smithery 安装
要通过 Smithery 自动为 Claude Desktop 安装 YouTube 字幕服务器,请运行:
bash
npx -y @smithery/cli install @kimtaeyoon83/mcp-server-youtube-transcript --client claude
组件
工具
get_transcript
从 YouTube 视频中提取字幕。
- 输入:
url
(字符串, 必需): YouTube 视频 URL 或视频 IDlang
(字符串, 可选, 默认: “en”): 字幕的语言代码 (例如: ‘ko’, ‘en’)
主要特点
- 支持多种视频 URL 格式
- 特定语言的字幕检索功能
- 响应中包含详细的元数据
配置
要与 Claude Desktop 一起使用,请添加以下服务器配置:
json
{
"mcpServers": {
"youtube-transcript": {
"command": "npx",
"args": [
"-y",
"@kimtaeyoon83/mcp-server-youtube-transcript"
]
}
}
}
通过工具 mcp-get 安装
mcp-get
是一个用于安装和管理模型上下文协议 (MCP) 服务器的命令行工具。
bash
npx @michaellatman/mcp-get@latest install @kimtaeyoon83/mcp-server-youtube-transcript
Awesome-mcp-servers
awesome-mcp-servers
是一个精心策划的、包含优秀模型上下文协议 (MCP) 服务器的列表。
开发
前提条件
- Node.js 18 或更高版本
- npm 或 yarn
设置
- 安装依赖项:
bash
npm install - 构建服务器:
bash
npm run build - 用于开发并自动重建:
bash
npm run watch
测试
bash
npm test
调试
由于 MCP 服务器通过 stdio(标准输入输出)进行通信,调试可能具有挑战性。我们推荐使用 MCP Inspector 进行开发:
bash
npm run inspector
运行评估 (evals)
evals
包加载一个 MCP 客户端,然后运行 index.ts
文件,因此测试之间无需重新构建。您可以通过在 npx 命令前加上环境变量来加载它们。完整文档可在此处找到。
bash
OPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/index.ts
错误处理
服务器实现了针对常见情况的强大错误处理机制:
- 无效的视频 URL 或 ID
- 不可用的字幕
- 语言可用性问题
- 网络错误
使用示例
- 通过视频 URL 获取字幕:
javascript
await server.callTool("get_transcript", {
url: "https://www.youtube.com/watch?v=VIDEO_ID",
lang: "en"
}); - 通过视频 ID 获取字幕:
javascript
await server.callTool("get_transcript", {
url: "VIDEO_ID",
lang: "ko"
});
如何在 Claude Desktop 应用中提取 YouTube 字幕
chat: https://youtu.be/ODaHJzOyVCQ?si=aXkJgso96Deri0aB Extract subtitles
安全注意事项
服务器:
- 验证所有输入参数
- 优雅地处理 YouTube API 错误
- 为字幕检索实现超时机制
- 提供详细的错误消息以便进行故障排除
许可证
该 MCP 服务器采用 MIT 许可证。详情请参见 LICENSE 文件。