内容
# 学习管家 MCP 🎓
一款使用人工智能将YouTube教育视频转化为学习资源的MCP（模型上下文协议）服务器。
## 功能
✅ 提取YouTube视频转录文本
✅ 生成简洁的视频摘要
✅ 创建结构化的学习笔记
✅ 生成多选题测验
✅ 创建复习闪卡
## 技术栈
- Python
- MCP（模型上下文协议）
- Claude Desktop
- Groq API
- YouTube Transcript API
- python-dotenv
## 项目结构
```text
StudyTube-MCP/
│
├── server.py
├── utils.py
├── requirements.txt
├── .env.example
├── README.md
└── screenshots/
```
## 安装
### 1. 克隆仓库
```bash
git clone https://github.com/your-username/StudyTube-MCP.git
cd StudyTube-MCP
```
### 2. 创建虚拟环境
```bash
python -m venv .venv
```
激活环境:
Windows:
```bash
.venv\Scripts\activate
```
### 3. 安装依赖
```bash
pip install -r requirements.txt
```
### 4. 配置环境变量
创建 `.env` 文件:
```env
GROQ_API_KEY=your_groq_api_key
```
## MCP 配置
将服务器添加到 Claude Desktop 配置:
```json
{
"mcpServers": {
"studytube": {
"command": "YOUR_PYTHON_PATH",
"args": [
"YOUR_SERVER_PATH\\server.py"
]
}
}
}
```
## 可用工具
### 1. summarize_video(url)
生成YouTube视频的简洁摘要。
示例:
```text
Summarize this video:
https://www.youtube.com/watch?v=VIDEO_ID
```
---
### 2. generate_video_notes(url)
创建结构化的学习笔记。
示例:
```text
Generate notes for:
https://www.youtube.com/watch?v=VIDEO_ID
```
---
### 3. generate_quiz(url)
从视频内容生成多选题测验。
示例:
```text
Generate a quiz for:
https://www.youtube.com/watch?v=VIDEO_ID
```
---
### 4. generate_flashcards(url)
创建复习闪卡。
示例:
```text
Generate flashcards for:
https://www.youtube.com/watch?v=VIDEO_ID
```
---
### 5. get_transcript(url)
检索YouTube视频的转录文本。
示例:
```text
Get transcript for:
https://www.youtube.com/watch?v=VIDEO_ID
```
## 示例工作流程
```text
YouTube URL
↓
转录文本提取
↓
Groq LLM 处理
↓
摘要 / 笔记 / 测验 / 闪卡
```
## 截图
添加以下截图：
- Claude 使用 summarize_video()
- Claude 生成笔记
- Claude 生成测验
- Claude 生成闪卡
## 未来改进
- 长视频转录文本分段
- 多语言支持
- PDF 导出
- Markdown 导出
- Anki 闪卡生成
- 学习进度跟踪
## 作者
Suganda Karaguppi
