Yt Mcp 100/100 — SaferSkills

Is Yt Mcp safe to install?

SaferSkills independently audited Yt Mcp (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.

CategoryWeightCategory scoreContribution

Securityprompt, exec, net, exfil, eval

35%

100

35.0 pts

Supply chainhash, typosquat, maintainer, lockfile

20%

100

20.0 pts

Maintenancestaleness, pinning, CI

15%

100

15.0 pts

TransparencySKILL.md, perms, README

15%

100

15.0 pts

Communityinstalls, verify, response

15%

100

15.0 pts

Findings & checks · 0 flagged

Securityscore 100 · 0 findings

✓—All security checks passedNo findings in this category for the latest scan.pass

Supply chainscore 100 · 0 findings

✓—All supply chain checks passedNo findings in this category for the latest scan.pass

Maintenancescore 100 · 0 findings

✓—All maintenance checks passedNo findings in this category for the latest scan.pass

Transparencyscore 100 · 0 findings

✓—All transparency checks passedNo findings in this category for the latest scan.pass

Communityscore 100 · 0 findings

✓—All community checks passedNo findings in this category for the latest scan.pass

The primary manifest — the file an agent reads to learn what this artifact does.

README.md · 1 file

README.md13.1 KB · Markdown

<h1 align="center">🎓 LearnFlow AI</h1> <h3 align="center">Your AI-Powered Learning Companion | Learn. Build. Play. 🚀</h3>

Free • Open Source • Learn Anything • No Limits

🌟 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." 💪

🎬 Why LearnFlow AI?

Problem	LearnFlow AI Solution
😵 Overwhelmed by YouTube tutorials	🎯 AI finds the BEST videos, filters out junk
📚 Don't know where to start	🗺️ Auto-generated learning roadmaps
⏰ No time to learn	⚡ 15-min daily micro-learning plans
💸 Can't afford courses	🆓 100% free YouTube-based learning
📅 No structure	📋 Week-by-week curriculum with projects
🤔 Outdated content	🆕 Finds recent, up-to-date tutorials

🚀 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!)

Go to Google Cloud Console
Create a new project (or select existing)
Enable YouTube Data API v3
Go to Credentials → Create Credentials → API Key
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)

Tool	Description
`search_youtube`	Search YouTube videos with smart ranking
`get_video_details`	Get comprehensive video info
`analyze_video`	Deep analysis with quality score & recommendations
`get_video_comments`	Analyze comment sentiment
`get_video_timestamps`	Extract chapters/timestamps
`compare_videos`	Side-by-side video comparison
`get_related_videos`	Find similar content
`get_video_transcript`	Get video transcript/summary info
`get_full_transcript`	Fetch complete video transcript
`analyze_channel`	Deep channel analysis
`get_channel_info`	Basic channel information
`set_youtube_api_key`	Set API key at runtime
`get_api_key_status`	Check API key status
`check_api_quota`	Monitor API usage

🎓 Learning Path Tools (3 Tools)

Tool	Description
`generate_learning_path`	Create week-by-week curriculum for ANY topic
`get_available_paths`	See suggested learning categories
`get_path_info`	Get details about a learning path

🧠 Smart Learning Tools (10 Tools)

Tool	Description
`smart_search`	Quality-filtered search (80%+ positive comments)
`generate_smart_roadmap`	AI-powered learning roadmap
`get_video_trust_score`	Calculate video quality score
`generate_topic_curriculum`	Detailed curriculum with phases
`get_prerequisites`	What to learn before a topic
`get_next_steps`	What to learn after completing topic
`find_best_video`	Find single best video for a topic
`get_learning_progress`	Track your learning journey
`update_learning_progress`	Mark topics as complete
`get_trending_in_tech`	Discover trending tech topics

💬 18 Built-in Prompts for Learning

🎯 Quick Learning Prompts

Prompt	What It Does
`find-best-recent`	Find BEST and most RECENT videos on any topic
`learn-in-one-hour`	Learn any topic in 60 minutes
`learn-before-tomorrow`	Emergency crash course for deadlines
`weekend-deep-dive`	Master a topic over the weekend (6-10 hrs)
`daily-micro-learning`	15-20 min daily learning habit

📚 Structured Learning Prompts

Prompt	What It Does
`create-learning-journey`	Personalized multi-week learning path
`weekly-study-plan`	Detailed plan for one week
`skill-assessment`	Assess your current level
`continue-learning`	Pick up where you left off
`quick-refresh`	Quick refresher on known topics

🔍 Research & Discovery Prompts

Prompt	What It Does
`deep-dive-topic`	Comprehensive research on a topic
`compare-technologies`	Compare frameworks/languages
`whats-new-in`	Latest updates in any technology
`explain-like-im-five`	Simple explanations for complex topics

🛠️ Project & Career Prompts

Prompt	What It Does
`project-roadmap`	Learn by building real projects
`code-along-project`	Find best build-along tutorials
`interview-prep`	Prepare for technical interviews
`debug-learning`	Get help when stuck

📖 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!

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

Variable	Description	Required
`YOUTUBE_API_KEY`	Your YouTube Data API key	Yes

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:

Action	Cost
Search	100 units
Video details	1 unit
Comments	1 unit

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"

Check the config file path is correct
Restart Claude Desktop completely
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

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
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

🎓 Start Learning Today! "The best time to learn was yesterday. The second best time is now."

Made with ❤️ by <a href="https://github.com/Shalin-Shah-2002">Shalin Shah</a>

<a href="https://github.com/Shalin-Shah-2002/Yt-MCP">⭐ Star this repo if it helps you learn something new!</a>

🚀 Let's Learn Together! 🚀

Is Yt Mcp safe to install?

🌟 What is LearnFlow AI?

🎬 Why LearnFlow AI?

🚀 Quick Start (5 Minutes Setup!)

Prerequisites

Step 1: Clone & Install

Step 2: Get YouTube API Key (Free!)

Step 3: Configure Claude Desktop

Step 4: Restart Claude Desktop

🛠️ 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

Example 2: Weekend Python Mastery

Example 3: Find Best Recent Tutorials

Example 4: Generate Full Learning Path

Example 5: Emergency Interview Prep

Example 6: Daily Learning Habit

🎯 Learning Paths for Any Topic!

Suggested Categories:

Popular Technologies:

Three Skill Levels:

🏗️ Project Architecture

🔧 Configuration Options

Environment Variables

Runtime Configuration

🎮 Fun Ways to Use LearnFlow AI

🏆 Challenge Mode

📅 Daily Streak

🆚 Tech Battle

🚀 Speed Run

🎯 Skill Tree

🔧 Development

Run in Development Mode

Run Tests

Check Syntax

Test Individual Components

🌟 What Makes LearnFlow AI Special?

✨ Quality First

🎯 Personalized

🆓 Completely Free

🤖 AI-Powered

📱 Any Topic

⏱️ Time-Aware

📊 API Quota Information

🐛 Troubleshooting

"API Key not configured"

"Claude doesn't show LearnFlow tools"

"Quota exceeded"

🗺️ Roadmap

🤝 Contributing

How to Contribute

📄 License

🙏 Acknowledgments

Audit the pieces. Scan the whole. Decide.