Youtube Obsidian MCP

📝 YouTube讲义MCP

从YouTube视频自动生成专业学习笔记

油管 + 克劳德·艾 + 黑曜石 =增压式学习

 

______________________________________________________________________

切勿手动截图并再次粘贴到笔记中！此MCP服务器与Claude Desktop集成，可自动提取字幕，在关键时间戳处捕获屏幕截图，并从任何YouTube教程或讲座中生成格式精美的黑曜石笔记。

______________________________________________________________________

✨ 特性

• 自动提取字幕 来自任何带有字幕的YouTube视频
• 截图 在您指定的时间戳
• 生成结构化笔记 黑曜石降价格式
• 有组织的元数据 带有标签、日期和视频链接
• 完整成绩单 包含在时间戳中
• 预览字幕 处理前
• 可定制的路径 为您的黑曜石金库组织
• 与Claude AI合作 用于自然语言交互

______________________________________________________________________

🎯 非常适合

从YouTube视频中学习 任何 主题：

______________________________________________________________________

🚀 快速开始

先决条件

安装前，请确保：

1. Python 3.10+ - 点击此处下载

- ⚠️ 安装时勾选“将Python添加到PATH”

1. FFmpeg -用于捕获视频截图
2. 克劳德桌面版 - 拿过来
3. 黑曜石 （可选但推荐）- 下载

安装

选项1：自动安装（推荐）

1. 克隆或下载此存储库
2. 在项目文件夹中打开PowerShell
3. 运行安装程序：

.\install.ps1

脚本将：

• ✅ 检查所有先决条件
• ✅ 安装所需的Python包
• ✅ 设置目录结构
• ✅ 生成Claude桌面配置

选项2：手动安装

查看详情 SETUP_GUIDE.md 获取分步说明。

______________________________________________________________________

💡 用法

安装后，只需在Claude Desktop中自然地与Claude交谈！

示例1：处理Python教程

Hey Claude, process this Python tutorial:
https://www.youtube.com/watch?v=rfscVS0vtbw

Capture screenshots at: 2:30, 8:15, 15:00, 22:45, 35:00
This is Day 1 of my learning journey.

示例2：处理前预览

Can you show me the subtitles for this video first?
https://www.youtube.com/watch?v=example

Then I'll tell you which timestamps to capture.

示例3：自定义组织

Configure my YouTube notes:
- Vault: D:\Learning\Obsidian
- Notes folder: Courses/Web Development
- Images folder: Courses/Web Development/assets

______________________________________________________________________

所得

每个处理过的视频都会创建：

1.Markdown笔记文件

Day 01 - Complete Python Course for Beginners.md

2.屏幕截图

day1_abc123_1_150s.jpg
day1_abc123_2_495s.jpg
day1_abc123_3_900s.jpg

3.结构化内容

---
date: 2026-01-16
day: 1
tags: [lecture, video-notes, learning]
video: "https://youtube.com/watch?v=..."
---

# Day 1: Complete Python Course for Beginners

> **Source**: [freeCodeCamp.org](https://youtube.com/...) > **Duration**: 4:26:54
> **Study Date**: 2026-01-16

## Summary

[Automatic summary from transcript]

## Key Concepts & Notes

### Timestamp 02:30

![Screenshot](images/day1_xxx_1_150s.jpg)

**Context from lecture:**

> In this section, we cover variables and data types...

**Key Points:**

- [Your notes here]

## Key Terms & Definitions

| Term | Definition |
| ---- | ---------- |
|      |            |

## Review Questions

1.
2.

## Personal Notes & Observations

[Your thoughts]

## Full Transcript

[Complete timestamped transcript]

______________________________________________________________________

🛠️ 可用工具

MCP服务器提供了三个可通过Claude访问的工具：

1. process_youtube_lecture

处理视频的主要工具：

• 提取字幕
• 按时间戳捕获屏幕截图
• 生成完整的黑曜石笔记

参数：

• url -YouTube视频URL（必填）
• timestamps -逗号分隔的时间，如“5:30、12:00、25:00”（必填）
• day_number -您的学习天数（必填）
• vault_path -自定义vault路径（可选）
• notes_folder -自定义笔记文件夹（可选）
• images_folder -自定义图像文件夹（可选）

2. get_video_subtitles

处理前预览完整成绩单：

• 返回带有时间戳的完整字幕
• 帮助您识别关键时刻

参数：

• url -YouTube视频URL（必填）

3. configure_paths

设置或查看默认路径：

• 配置黑曜石保险库位置
• 设置自定义文件夹结构

参数：

• vault_path -新vault路径（可选）
• notes_folder -新笔记文件夹（可选）
• images_folder -新建图像文件夹（可选）

______________________________________________________________________

📂 文件结构

安装后，您的文件将按如下方式组织：

C:\Users\YourName\
├── mcp-servers\
│   └── youtube-lecture-notes\
│       ├── server.py
│       └── claude_config_snippet.json
│
└── Documents\
    └── ObsidianVault\
        └── Lecture Notes\
            ├── Day 01 - Python Basics.md
            ├── Day 02 - Advanced Functions.md
            └── images\
                ├── day1_xxx_1_150s.jpg
                ├── day1_xxx_2_495s.jpg
                └── day2_xxx_1_300s.jpg

______________________________________________________________________

🔧 故障排除

常见问题

“无法识别python”

• 重新安装Python并选中“添加到PATH”
• 或者在配置中指定完整路径： C:\\Python312\\python.exe

“无法识别ffmpeg”

• 安装FFmpeg： winget install ffmpeg
• 安装后重新启动终端
• 验证： ffmpeg -version

“找不到字幕”

• 检查视频是否在YouTube上启用了字幕
• 尝试使用其他视频进行测试
• 有些视频可能没有字幕

MCP未连接

• 验证中的路径 claude_desktop_config.json 使用双反睫毛 \\
• 完全重新启动克劳德桌面
• 在“设置”>“开发人员”中检查Claude Desktop日志

未捕获的屏幕截图

• 确保FFmpeg安装正确
• 视频可能受地区限制
• 某些视频阻止下载

有关更多帮助，请参阅 SETUP_GUIDE.md 或者在GitHub上发布一个问题。

______________________________________________________________________

🎓 最佳结果提示

1. 先预览 -使用 get_video_subtitles 在选择时间戳之前扫描内容
2. 选择关键时刻 -为每个视频选择4-6个重要时间戳（不要做得太过火！）
3. 以2倍速度观看 -快速识别主要概念的引入位置
4. 填空 -这些笔记提供了结构，但增加了你自己的见解
5. 用标签组织 -自定义 tags: 在你的主题的头版
6. 定期审查 -使用复习问题部分测试自己

______________________________________________________________________

🎨 自定义笔记样式

生成的笔记是 完全可定制 以匹配您的个人学习风格和偏好！

您可以自定义的内容

1. 注释结构和截面

• 根据您的需求添加自定义部分（代码段、公式、工作流）
• 重新排序部分以匹配您的思维过程
• 删除不使用的部分
• 为不同主题创建模板

2. 格式和样式

• 更改标题样式和层次结构
• 自定义表情符号使用和视觉标记
• 调整术语和定义的表格布局
• 修改YAML frontmatter标签和元数据

3. 组织

• 按主题、难度或课程自定义文件夹结构
• 标签系统，便于过滤和链接
• 适合您的命名约定
• 与现有的黑曜石拱顶结构集成

4. 内容增强

• 添加自己的代码块，并突出显示语法
• 包括外部资源的链接
• 嵌入其他图像或图表
• 创建指向相关笔记的内部wiki链接

如何自定义

查看综合 定制.md 指南：

• 分步定制说明
• 为不同学习风格预先制作的模板
• 特定主题的笔记结构（编程、设计、商业等）
• 高级黑曜石集成技巧
• 自定义注释示例

快速自定义提示：

• 编辑 server.py 第254-349行更改默认注释模板
• 生成后修改frontmatter中的标签
• 使用黑曜石模板进行后处理
• 为自定义样式创建黑曜石CSS片段

💡 你的笔记，你的方式 -从默认结构开始，随着你发现什么最适合你的学习而不断发展！

______________________________________________________________________

🤝 贡献

欢迎投稿！请随意：

• 🐛 报告错误
• 💡 建议新功能
• 🔧 提交拉取请求
• 📖 改进文档

______________________________________________________________________

致谢

内置：

• yt-dlp -YouTube下载工具
• FFmpeg -视频处理
• 黑曜石 -知识管理

______________________________________________________________________

📚 文档

• SETUP_GUIDE.md -详细的安装和设置说明
• CLAUDE.md -Claude AI关于如何有效使用此MCP的说明
• 示例_注释.md -示例注释结构和模板
• 定制.md -自定义笔记样式的完整指南

______________________________________________________________________

📬 支持与社区

• 文档：检查 SETUP_GUIDE.md
• 致克劳德·AI：参见 CLAUDE.md 关于使用指南
• 问题: 在此处报告错误
• 讨论：分享您的用例和技巧
• 许可证: MIT许可证

______________________________________________________________________

由...制作❤️ 面向世界各地的学习者 通过 莫赫辛·卡迪姆