YouTube MCP VS代码工具
🎬 Bring YouTube video intelligence directly into VS Code
Search • Analyze • Transcribe • Generate Flashcards
✨ 它做什么
| 是否需要工具 | API密钥? | 用例 |
|---|---|---|
| 📝 获取成绩单 | ❌ 否 | “给我这个视频的文字记录”-返回带有可点击时间戳的Markdown,这样AI就可以引用特定的时刻,你就可以跳到那里 |
| 🔎 在成绩单内搜索 | ❌ 否 | “在这个2小时的播客中,他们在哪里提到了X?”-返回匹配的时刻+深度链接URL,比将整个成绩单转储到人工智能中便宜得多 |
| 📈 配额状态 | ❌ 否 | 查看此服务器使用了多少YouTube Data API配额 |
| 🔍 搜索YouTube | ✅ 是 | 按查询搜索视频(100个配额单位=免费层每天约100次搜索) |
| 📊 获取视频详细信息 | ✅ 是 | 标题、频道、持续时间、浏览/点赞计数、标签、字幕可用性 |
| 🧠 分析视频 | ✅ 是 | 总结、要点、主题、提取的概念、可观察到的质量信号 |
| 🎴 生成抽认卡 | ✅ 是 | 关键概念的前/后学习卡 |
> 成绩单工具在没有Google API密钥的情况下工作。 这涵盖了
> 最常见的用例(“为我总结这个视频”)为零
> 设置。如果您也需要搜索和分析,请稍后添加API密钥。
⚡ 快速启动(MCP服务器,无API密钥)
从任何MCP客户端(Claude Desktop、VS Code Agent)尝试它的最快方法
模式、光标、自定义代理):
1.添加到MCP客户端配置
.vscode/mcp.json:```json
{
"servers": {
"youtube": {
"command": "node",
"args": ["${workspaceFolder}/node_modules/youtube-mcp-tools/dist/mcp-server.js"]
}
}
}
克劳德桌面(`claude_desktop_config.json`):```json
{
"mcpServers": {
"youtube": {
"command": "node",
"args": ["/absolute/path/to/dist/mcp-server.js"]
}
}
}
2.问你的AI
> “获取成绩单 https://youtu.be/jNQXAC9IVRw 告诉我这是怎么回事。"
> “In https://youtu.be/dQw4w9WgXcQ他们在哪里说“永远不会”?"
AI呼叫 youtube_get_transcript 或 youtube_search_transcript,得到
返回Markdown 03:42 可点击的时间戳,
并在回答中引用了它们。
3.(可选)为更丰富的工具添加API密钥
集 YOUTUBE_API_KEY 在您的MCP客户的 env 阻止解锁搜索,
视频细节、完整分析和抽认卡。
📦 安装(VS代码扩展)
- 打开VS代码
- 按
Ctrl+P/Cmd+P - 类型
ext install fabioc-aloha.youtube-mcp-tools - 按Enter键
或 在“扩展”视图中搜索“YouTube MCP工具”。
⚙️ 设置
获取YouTube API密钥
- 首选 谷歌云控制台
- 创建新项目(或选择现有项目)
- 启用 YouTube数据API v3
- 创建API密钥
- 复制密钥
配置扩展
选项1:VS代码设置 (推荐)```
Ctrl+, → Search "youtubeMcp.apiKey" → Paste your key
**选项2:.env文件**
创建一个 `.env` 工作区根目录中的文件:```env
YOUTUBE_API_KEY=your-api-key-here
选项3:安全命令 (推荐)
跑 YouTube MCP: Set API Key 命令。您的密钥是:
- 储存前已验证
- 使用VS Code SecretStorage加密
- 从未在设置或文件中公开
🎯 命令
| 命令 | 快捷方式 | 描述 |
|---|---|---|
YouTube MCP: Search YouTube |
Ctrl+Shift+Y S |
按关键字搜索视频 |
YouTube MCP: Analyze Video |
Ctrl+Shift+Y A |
获得全面的视频分析 |
YouTube MCP: Get Transcript |
Ctrl+Shift+Y T |
提取带时间戳的成绩单 |
YouTube MCP: Generate Flashcards |
Ctrl+Shift+Y F |
从视频创建抽认卡 |
YouTube MCP: Set API Key |
- | 安全地设置API密钥 |
YouTube MCP: Show Quota Status |
- | 检查API配额使用情况 |
YouTube MCP: Open Settings |
- | 配置扩展设置 |
通过访问所有命令 Ctrl+Shift+P / Cmd+Shift+P.
🔒 安全特性
- 加密存储 -存储在VS Code的SecretStorage中的API密钥
- 密钥验证 -存储前验证API密钥
- 速率限制 -自动请求限制(10请求/秒)
- 指数退避 -针对暂时性故障的智能重试
- 配额持久性 -跨会话持续跟踪使用情况
📊 视频分析输出
当你分析一个视频时,你会得到:```markdown
Video Title
Channel: Channel Name
Duration: 15m 30s
Views: 1,234,567 | Likes: 45,678
Summary
Brief overview of the video content...
Detailed
In-depth analysis of the video...
Key Points
- Important point 1
- Important point 2
- Important point 3
Key Concepts
Machine Learning
Definition and context...
Type: term | Mentions: 15
Quality Signals
| Signal | Value |
|---|---|
| Has captions | yes |
| Word count | 4,318 |
| Avg sentence length | 18 words |
| Engagement (likes/views) | 3.70% |
| Transcript segments | 412 |
> 质量报告为 **可测量信号**,不是不透明的0-100分。
> 根据您的用例解释它们——长篇讲座需要不同的
> 信号比简短的教程。
## 🤖 从任何MCP客户端使用
除了VS Code UI之外,此软件包还附带了一个独立的 **模型上下文
协议** 服务器(`youtube-mcp-server`).任何支持MCP的客户端都可以调用其
工具-- `youtube_search`, `youtube_get_video_details`,
`youtube_get_transcript`, `youtube_analyze_video`,
`youtube_generate_flashcards`, `youtube_quota_status`.
### VS代码代理模式(`.vscode/mcp.json`)```json
{
"servers": {
"youtube": {
"command": "node",
"args": ["${workspaceFolder}/node_modules/youtube-mcp-tools/dist/mcp-server.js"],
"env": { "YOUTUBE_API_KEY": "${env:YOUTUBE_API_KEY}" }
}
}
}
克劳德桌面(claude_desktop_config.json)```json
{
"mcpServers": {
"youtube": {
"command": "node",
"args": ["/absolute/path/to/dist/mcp-server.js"],
"env": { "YOUTUBE_API_KEY": "AIza..." }
}
}
}
### 独立```bash
YOUTUBE_API_KEY=AIza... node dist/mcp-server.js
服务器通过stdio进行JSON-RPC通信。日志只会转到stderr——stdout是
为协议信道保留。
🎴 闪存卡生成
闪卡由以下来源生成:
- 要点 从视频中提取
- 概念 在内容中标识
- 话题 视频中涵盖
非常适合:
- 📚 学习新技术
- 🎓 学习认证
- 💡 保留视频课程内容
⚙️ 设置
| 设置 | 默认值 | 说明 |
|---|---|---|
youtubeMcp.apiKey |
- | 您的YouTube数据API密钥 |
youtubeMcp.maxResults |
10 | 搜索结果(1-50) |
youtubeMcp.preferredDuration |
any | 过滤器:任意、短、中、长 |
youtubeMcp.defaultRegion |
美国 | 搜索区域代码 |
youtubeMcp.autoAnalyze |
false | 自动分析视频选择 |
📁 活动栏视图
寻找 油管 活动栏中的图标:
- 🔍 搜索结果 -上次搜索的视频
- 📜 最近的视频 -您的视频历史记录
- 🎴 抽认卡 -生成学习卡
🔒 隐私和安全
- ✅ 本地存储在VS代码设置中的API密钥或
.env - ✅ 没有数据发送到第三方服务器
- ✅ 无遥测或跟踪
- ✅ 所有处理都在本地进行
📝 需求
- VS代码1.109.0或更高
- YouTube数据API密钥(免费获得一个)
🤝 贡献
欢迎投稿!请查看我们的 GitHub存储库.
- 分叉存储库
- 创建要素分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
Made with ❤️ by CorreaX
Building intelligent tools for developers
Report Bug •
Request Feature •
⭐ Star on GitHub
