# StudyTube MCP 🎓

An MCP (Model Context Protocol) server that transforms YouTube educational videos into learning resources using AI.

## Features

✅ Extract YouTube video transcripts

✅ Generate concise video summaries

✅ Create structured study notes

✅ Generate multiple-choice quizzes

✅ Create flashcards for revision

## Tech Stack

- Python
- MCP (Model Context Protocol)
- Claude Desktop
- Groq API
- YouTube Transcript API
- python-dotenv

## Project Structure

```text
StudyTube-MCP/
│
├── server.py
├── utils.py
├── requirements.txt
├── .env.example
├── README.md
└── screenshots/
```

## Installation

### 1. Clone Repository

```bash
git clone https://github.com/your-username/StudyTube-MCP.git
cd StudyTube-MCP
```

### 2. Create Virtual Environment

```bash
python -m venv .venv
```

Activate environment:

Windows:

```bash
.venv\Scripts\activate
```

### 3. Install Dependencies

```bash
pip install -r requirements.txt
```

### 4. Configure Environment Variables

Create a `.env` file:

```env
GROQ_API_KEY=your_groq_api_key
```

## MCP Configuration

Add the server to Claude Desktop configuration:

```json
{
  "mcpServers": {
    "studytube": {
      "command": "YOUR_PYTHON_PATH",
      "args": [
        "YOUR_SERVER_PATH\\server.py"
      ]
    }
  }
}
```

## Available Tools

### 1. summarize_video(url)

Generates a concise summary of a YouTube video.

Example:

```text
Summarize this video:
https://www.youtube.com/watch?v=VIDEO_ID
```

---

### 2. generate_video_notes(url)

Creates structured study notes.

Example:

```text
Generate notes for:
https://www.youtube.com/watch?v=VIDEO_ID
```

---

### 3. generate_quiz(url)

Generates multiple-choice questions from video content.

Example:

```text
Generate a quiz for:
https://www.youtube.com/watch?v=VIDEO_ID
```

---

### 4. generate_flashcards(url)

Creates flashcards for revision.

Example:

```text
Generate flashcards for:
https://www.youtube.com/watch?v=VIDEO_ID
```

---

### 5. get_transcript(url)

Retrieves the transcript of a YouTube video.

Example:

```text
Get transcript for:
https://www.youtube.com/watch?v=VIDEO_ID
```

## Example Workflow

```text
YouTube URL
      ↓
Transcript Extraction
      ↓
Groq LLM Processing
      ↓
Summary / Notes / Quiz / Flashcards
```

## Screenshots

Add screenshots of:

- Claude using summarize_video()
- Claude generating notes
- Claude generating quizzes
- Claude generating flashcards

## Future Improvements

- Transcript chunking for long videos
- Multi-language support
- PDF export
- Markdown export
- Anki flashcard generation
- Learning progress tracking

## Author

Suganda Karaguppi