LearnFlow AI

🌟 What is LearnFlow AI?

LearnFlow AI is a revolutionary MCP (Model Context Protocol) server that transforms how you learn programming and technology. It connects directly to Claude AI and gives it superpowers to:

• 🎯 Find the BEST YouTube tutorials for any topic

• 📚 Generate personalized learning paths for ANY skill

• 🔍 Filter videos by quality (80%+ positive comments only!)

• ⏱️ Create time-based study plans (1 hour, weekend, daily micro-learning)

• 🎓 Track your learning progress

• 🆕 Stay updated with latest tech news and features

"Learn anything, build everything, pay nothing." 💪

Related MCP server: SkillForge

🎬 Why LearnFlow AI?

🚀 Quick Start (5 Minutes Setup!)

Prerequisites

• Node.js 18+ - Download here

• YouTube Data API Key - Get free key here

• Claude Desktop - Download here

Step 1: Clone & Install

# Clone the repository
git clone https://github.com/Shalin-Shah-2002/Yt-MCP.git

# Navigate to project
cd Yt-MCP

# Install dependencies
npm install

Step 2: Get YouTube API Key (Free!)

1. Go to Google Cloud Console

2. Create a new project (or select existing)

3. Enable YouTube Data API v3

4. Go to Credentials → Create Credentials → API Key

5. Copy your API key

Step 3: Configure Claude Desktop

Add this to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "learnflow-ai": {
      "command": "node",
      "args": ["/FULL/PATH/TO/Yt-MCP/src/server.js"],
      "env": {
        "YOUTUBE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

💡 Replace /FULL/PATH/TO/Yt-MCP with actual path and add your API key!

Step 4: Restart Claude Desktop

Close and reopen Claude Desktop. You should see LearnFlow AI tools available! 🎉

🛠️ All Features & Tools (27 Total!)

📹 YouTube Tools (14 Tools)

🎓 Learning Path Tools (3 Tools)

🧠 Smart Learning Tools (10 Tools)

💬 18 Built-in Prompts for Learning

🎯 Quick Learning Prompts

📚 Structured Learning Prompts

🔍 Research & Discovery Prompts

🛠️ Project & Career Prompts

📖 How to Use LearnFlow AI

Example 1: Learn React in One Hour

Just ask Claude:

Use the learn-in-one-hour prompt with topic="React hooks"

Example 2: Weekend Python Mastery

Use the weekend-deep-dive prompt with topic="Python" total_hours="8" include_project="yes"

Example 3: Find Best Recent Tutorials

Use find-best-recent prompt with topic="Next.js 14" recency="this-month"

Example 4: Generate Full Learning Path

Use generate_learning_path tool with goal="Machine Learning" level="beginner"

Example 5: Emergency Interview Prep

Use learn-before-tomorrow prompt with topic="System Design" purpose="interview" hours_available="4"

Example 6: Daily Learning Habit

Use daily-micro-learning prompt with topic="TypeScript" daily_minutes="20" days="7"

🎯 Learning Paths for Any Topic!

LearnFlow AI can generate learning paths for ANY topic. The system is fully dynamic!

Suggested Categories:

• 🌐 Web Development

• 📱 Mobile Development

• 🤖 Machine Learning

• 📊 Data Science

• ⚙️ DevOps

• ☁️ Cloud Computing

• 🔒 Cybersecurity

• 🎮 Game Development

• ⛓️ Blockchain

• 🎨 UI/UX Design

Popular Technologies:

React, Vue, Angular, Next.js, Node.js, TypeScript, Flutter, React Native, Swift, Kotlin, Python, TensorFlow, PyTorch, Docker, Kubernetes, AWS, Azure, and many more!

Three Skill Levels:

• 🌱 Beginner (6 weeks) - Start from zero

• 🌿 Intermediate (6 weeks) - Level up your skills

• 🌳 Advanced (8 weeks) - Become an expert

🏗️ Project Architecture

Yt-MCP/
├── src/
│   ├── server.js              # MCP server entry point
│   ├── config/
│   │   └── config.js          # Configuration management
│   ├── controllers/
│   │   ├── youtubeController.js
│   │   ├── learningPathController.js
│   │   └── smartLearningController.js
│   ├── models/
│   │   ├── TopicTree.js       # Dynamic topic suggestions
│   │   └── LearningPath.js    # Learning path structure
│   ├── services/
│   │   ├── youtubeService.js  # YouTube API integration
│   │   ├── learningPathService.js
│   │   └── smartLearningService.js
│   ├── prompts/
│   │   └── promptManager.js   # 18 built-in prompts
│   └── utils/
│       ├── videoFormatter.js
│       └── errorHandler.js
├── package.json
└── README.md

🔧 Configuration Options

Environment Variables

Runtime Configuration

You can also set the API key through Claude:

Use set_youtube_api_key tool with apiKey="YOUR_KEY"

Check your API status:

Use get_api_key_status tool

🎮 Fun Ways to Use LearnFlow AI

🏆 Challenge Mode

"I want to learn Docker in one weekend. Create an intensive plan with a project!"

📅 Daily Streak

"Set up a 30-day JavaScript challenge with 20 minutes daily learning"

🆚 Tech Battle

"Compare React vs Vue vs Angular for a beginner who wants to get a job quickly"

🚀 Speed Run

"I have an interview tomorrow about Kubernetes. Emergency crash course please!"

🎯 Skill Tree

"Create a complete Full Stack Developer roadmap from zero to hero"

🔧 Development

Run in Development Mode

npm run dev

Run Tests

npm test

Check Syntax

node --check src/server.js

Test Individual Components

# Test transcript service
node test-transcript.mjs

# Test prompts
node -e "import('./src/prompts/promptManager.js').then(m => console.log(new m.PromptManager().listPrompts()))"

🌟 What Makes LearnFlow AI Special?

✨ Quality First

Only recommends videos with 80%+ positive comments. No more wasting time on bad tutorials!

🎯 Personalized

Adapts to YOUR skill level, time availability, and learning style.

🆓 Completely Free

Uses free YouTube content + free YouTube API. No subscriptions, no hidden costs.

🤖 AI-Powered

Leverages Claude AI to understand your needs and create perfect learning plans.

📱 Any Topic

Not limited to pre-defined paths. Learn literally anything from Kubernetes to Origami!

⏱️ Time-Aware

Whether you have 15 minutes or a whole weekend, LearnFlow creates the perfect plan.

📊 API Quota Information

YouTube Data API has a free quota of 10,000 units/day. Typical usage:

This means you can do approximately 100 searches per day for free!

🐛 Troubleshooting

"API Key not configured"

Make sure you've set YOUTUBE_API_KEY in your Claude Desktop config or use the set_youtube_api_key tool.

"Claude doesn't show LearnFlow tools"

1. Check the config file path is correct

2. Restart Claude Desktop completely

3. Check the path to server.js is absolute

"Quota exceeded"

You've hit the daily YouTube API limit. Wait 24 hours or create a new API key.

🗺️ Roadmap

• 📊 Learning analytics dashboard

• 🔄 Playlist support

• 📝 Note-taking integration

• 🎯 Quiz generation from videos

• 📱 Mobile companion app

• 🌍 Multi-language support

🤝 Contributing

We welcome contributions! Feel free to:

• 🐛 Report bugs

• 💡 Suggest features

• 🔧 Submit PRs

• ⭐ Star the repo

How to Contribute

1. Fork the repository

2. Create your feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

📄 License

MIT License - Use it, modify it, share it! 🎉

🙏 Acknowledgments

• YouTube Data API - For access to the world's largest video library

• Anthropic Claude - For the amazing MCP protocol

• Open Source Community - For inspiration and support