article
README
🚀 YouTube 集成
YouTube MCP 服务器具备从 YouTube 视频中提取字幕的强大功能,为用户获取视频字幕提供了便利。
🚀 快速开始
若要获取 YouTube 视频的字幕文本,你可以使用该服务器提供的功能。
获取 YouTube 字幕文本
此功能可检索 YouTube 视频的字幕文字。
参数:
| 属性 | 详情 |
| ---- | ---- |
| videoUrl | 完整的 YouTube 视频 URL(支持标准、缩短和嵌入式 URL) |
返回:包含以下内容的对象:
| 属性 | 详情 |
| ---- | ---- |
| content | 包含字幕文字的数组 |
支持的 URL 格式
该服务器能够处理多种 YouTube URL 格式:
- 标准:
https://www.youtube.com/watch?v=VIDEO_ID - 短链接:
https://youtu.be/VIDEO_ID - 嵌入式:
https://www.youtube.com/embed/VIDEO_ID
错误处理
该服务器实现了标准的错误处理机制:
- 若传入无效 URL,将返回
ErrorCode.InvalidParams。 - 若缺少 URL,同样返回
ErrorCode.InvalidParams。 - 若字幕获取失败,将返回格式化的错误消息。
- 当收到 SIGINT 信号时,服务器会优雅关闭。
🔧 技术细节
- 此服务器使用 Highlight AI MCP SDK 构建。
- 借助 youtube-transcript 库来实现字幕提取功能。
- 通过 Zod 进行输入验证,确保输入的有效性。
- 作为基于标准输入输出的 MCP 服务器运行。
- 支持 Node.js >=18.0.0 版本。
⚠️ 局限性
⚠️ 重要提示
- 该服务器只能用于启用字幕的视频。
- 当前仅返回英文字幕。
- 速率限制取决于 YouTube API 的限制。
扫码联系在线客服