一种模型上下文协议服务器,支持从YouTube视频中检索字幕,并提供特定语言的支持。
image-and-video-processingentertainment-and-media
727 查看 · 2026-07-07 更新
简介
一种模型上下文协议服务器,支持从YouTube视频中检索字幕,并提供特定语言的支持。
简介
一种模型上下文协议服务器,支持从YouTube视频中检索字幕,并提供特定语言的支持。
YouTube 字幕服务器
这是一个 Model Context Protocol 服务器,可以从 YouTube 视频中检索字幕。该服务器通过简单的接口直接访问视频字幕和字幕。
通过 Smithery 安装
要通过 Smithery 自动安装适用于 Claude Desktop 的 YouTube 字幕服务器:
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 中使用此服务器,请添加以下配置:
{ "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
错误处理
服务器为常见场景实现了强大的错误处理:
- 无效的视频 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 Extract subtitles
安全注意事项
服务器:
- 验证所有输入参数
- 优雅地处理 YouTube API 错误
- 为字幕检索实现超时
- 提供详细的错误消息以便故障排除
许可证
本 MCP 服务器根据 MIT 许可证发布。详情请参见 LICENSE 文件。
服务配置
[{'mcpServers': {'youtube-transcript': {'args': ['-y', '@kimtaeyoon83/mcp-server-youtube-transcript'], 'command': 'npx'}}}]