Youtube

@inlustris/youtube-mcp

让 AI Agent 以 YouTube 上的优质内容为依据——无需 API 密钥，零配置。

YouTube 是世界上最大的专业知识库，汇集了教程、演讲、评测和深度解析。但 AI Agent 无法观看视频。

这个 MCP 服务弥补了这一差距。它通过简单的工具，为你的 Agent 提供 YouTube 字幕、搜索、频道数据和视频截图。无需 Google API 密钥，无需 OAuth，无需设置。

基于 FastMCP 和 youtubei.js 构建。

为什么用 YouTube 为 AI 提供依据？

网页搜索结果杂乱无章。YouTube 内容经过排序、评审和筛选——高播放量的视频、值得信赖的创作者，以及带时间戳的字幕，使其非常适合用作大模型上下文。你的 Agent 无需抓取论坛或博客，就能从相关视频中提取完整字幕、跨频道搜索，或截取特定时刻的画面。

这不是另一个需要你维护的“AI 技能”，而是一个安装后即可使用的 npm 包。

你将获得

工具	用途
get_transcript	获取带时间戳的视频字幕，或通过 plainText 获取纯文本。可选择通过 skipSponsor 去除赞助内容片段。字幕会缓存在内存中，后续获取速度极快。
get_video_frame	截取任意时间戳的画面。yt-dlp 可用时提供完整画质；否则会自动切换为备用方案。
search_videos	搜索 YouTube，可按相关性、日期、评分和播放量排序。
search_channels	根据查询查找频道。
get_channel_videos	列出频道中的所有视频。

安装

npm install -g @inlustris/youtube-mcp

添加到任何 MCP 客户端：

{
  "mcpServers": {
    "youtube": {
      "command": "npx",
      "args": ["-y", "@inlustris/youtube-mcp@latest"]
    }
  }
}

兼容 Claude Desktop、Cursor、opencode、VS Code Copilot 及任何兼容 MCP 的 Agent。

全画质截图（可选）

get_video_frame 开箱即用，可使用 YouTube 故事板截图（320×180）。如需全分辨率截图（720p、1080p、4K），请安装系统工具：

brew install yt-dlp ffmpeg

该工具会自动检测 yt-dlp 并升级截图质量，无需更改配置。

SponsorBlock

向 get_transcript 传入 skipSponsor: true。它会从 SponsorBlock API 获取赞助内容的时间戳（无需身份验证，免费），并从字幕中移除赞助内容。非常适合获取干净、无广告的视频上下文。

使用场景

• 研究 Agent：提取专家演讲、会议演讲或技术深度解析的字幕，无需浏览博客文章。
• 内容分析：按主题搜索相关 YouTube 内容，然后大规模提取字幕。
• 视觉依据：在关键时刻截取画面，并结合字幕进行多模态理解。
• 学习工具：让用户针对特定视频时间戳提问，并获得有依据的回答。

开发

npm install
npm run dev        # hot-reload
npm test           # 31 tests
npm run build      # production bundle

src/
├── index.ts
├── server/server.ts
├── core/
│   ├── tools.ts
│   ├── resources.ts
│   └── services/
│       ├── youtube-service.ts
│       ├── sponsorblock-service.ts
│       └── screenshot-service.ts
└── __tests__/

许可证

MIT