🚀 GitHub MCP + AI Agents Framework

Three powerful agents for GitHub automation, job market intelligence, and trending tech discovery

A clean, organized framework with 3 main components:

• 🔗 GitHub MCP - Connect AI to GitHub
• 💼 Job Analyzer - Analyze tech trends & job market
• 📈 Trending Digest - Weekly trending repos + AI trends + Slack integration

🎯 Three Agents, Three Superpowers

1️⃣ GitHub MCP - AI Meets GitHub

📁 github-mcp/

Connect AI models to GitHub through Model Context Protocol.

Can:

• ✅ Search repositories
• ✅ Analyze projects
• ✅ Track issues & PRs
• ✅ Generate reports
• ✅ Integrate with VS Code Copilot.

Run: npm start

→ Go to GitHub MCP →

2️⃣ Job Analyzer - Market Intelligence

📁 job-analyzer/

Analyze GitHub trends and correlate with real job market data.

Shows:

• ✅ Trending technologies
• ✅ Job market demand
• ✅ Salary data by language
• ✅ Career progression paths
• ✅ Top companies hiring

Run: npm run job-market

→ Go to Job Analyzer →

3️⃣ Trending Digest - Weekly Intelligences Hub 🆕

📁 trending-digest/

Proactive weekly digest of trending repositories, AI trends, and job market correlation sent to Slack.

Delivers:

• 📊 Top 15 trending repos per language weekly
• 🤖 Latest AI/ML project discoveries (top 20 trending)
• 💼 Real-time job market correlation
• 📰 Professional newsletter generation
• 💬 Automatic Slack channel posts
• 🧠 Smart "how to get started" recommendations
• 📈 Statistics & market insights
• 📁 JSON export for further analysis

Run: npm run trending-digest

→ Go to Trending Digest →

⚡ Quick Start (5 minutes)

Step 1: Get GitHub Token

1. Go to https://github.com/settings/tokens
2. Generate new token (classic)
3. Select: repo, gist, user
4. Copy token

Step 2: Set Environment Variable

# PowerShell as Administrator:
[Environment]::SetEnvironmentVariable("GITHUB_TOKEN", "ghp_xxxxxxxxxxxx", "User")

Step 3: Install & Run

npm install

# Try GitHub MCP:
npm start

# Try Job Analyzer:
npm run job-market

Troubleshooting? → See docs/ENVIRONMENT_SETUP.md

📁 Project Structure

mcp-github-agents/
│
├── 🔗 github-mcp/          ← Component 1: GitHub MCP
│   ├── README.md           (Setup & quick start)
│   ├── src/agent.js        (GitHub agent code)
│   └── docs/               (MCP documentation)
│       ├── ARCHITECTURE.md
│       ├── USAGE.md
│       └── EXAMPLES.md
│
├── 💼 job-analyzer/        ← Component 2: Job Analyzer
│   ├── README.md           (Setup & quick start)
│   ├── src/job-market-analyzer.js
│   └── docs/               (Analyzer documentation)
│       ├── GUIDE.md
│       ├── EXAMPLES.md
│       └── DATA.md
│
├── � trending-digest/     ← Component 3: Trending Digest 🆕
│   ├── README.md           (Quick start & overview)
│   ├── src/trending-digest.js (Trending agent code)
│   ├── docs/               (Comprehensive guides)
│   │   ├── GUIDE.md        (Complete feature guide)
│   │   ├── EXAMPLES.md     (15+ code examples)
│   │   └── SLACK_SETUP.md  (Slack integration setup)
│   └── exports/            (Generated reports)
│       └── trending-digest.json
│
├── �📚 docs/                ← Shared documentation
│   ├── ENVIRONMENT_SETUP.md
│   ├── QUICK_REFERENCE.md
│   ├── INSTALLATION.md
│   └── TROUBLESHOOTING.md
│
├── .vscode/                (VS Code MCP config)
├── package.json
├── README.md               (This file)
├── CONTRIBUTING.md
└── LICENSE

🚀 Commands

| Command | Component | What It Does | |---------|-----------|--------------| | npm start | GitHub MCP | Run GitHub analysis agent | | npm run job-market | Job Analyzer | Analyze job market trends | | npm run trending-digest | Trending Digest | Generate weekly digest + post to Slack | | npm install | All | Install dependencies |

📚 Documentation

For GitHub MCP

• github-mcp/README.md - Quick start
• github-mcp/docs/ARCHITECTURE.md - System design
• github-mcp/docs/USAGE.md - How to use
• github-mcp/docs/EXAMPLES.md - Code examples

For Job Analyzer

• job-analyzer/README.md - Quick start
• job-analyzer/docs/GUIDE.md - Complete guide
• job-analyzer/docs/EXAMPLES.md - Code examples

For Trending Digest 🆕

• trending-digest/README.md - Quick start & overview
• trending-digest/docs/GUIDE.md - Complete feature guide
• trending-digest/docs/EXAMPLES.md - 15+ code examples
• trending-digest/docs/SLACK_SETUP.md - Slack integration

Shared Documentation

• docs/ENVIRONMENT_SETUP.md - Token setup (all agents)
• docs/QUICK_REFERENCE.md - Commands list
• docs/INSTALLATION.md - Full setup guide
• CONTRIBUTING.md - How to contribute

🎓 Choose Your Learning Path

👶 Complete Beginner?

1. Read this README
2. Pick a component (1, 2, or 3)
3. Read its README.md
4. Run it: npm start, npm run job-market, or npm run trending-digest
5. Explore examples

⚡ Want Examples Immediately?

1. Run: npm install
2. Set GitHub token
3. Run: npm start or npm run trending-digest
4. Check output
5. Read component EXAMPLES.md

🔧 Technical Dive?

1. Read architecture docs
2. Check source code
3. Explore examples in each component
4. Build your own agent

💼 Career Planning?

1. Read job-analyzer/README.md
2. Run: npm run job-market
3. Review job analyzer guide
4. Career path analysis

📈 Stay Current with Trends?

1. Read trending-digest/README.md
2. Run: npm run trending-digest
3. Set up Slack integration (optional)
4. Get weekly digest in Slack!

✨ Features

GitHub MCP Component

• Repository search by keyword
• Get repository statistics
• List open issues & PRs
• GitHub API integration
• Error handling & validation
• Formatted console output
• VS Code Copilot integration ready

Job Analyzer Component

• GitHub trending analysis by language
• Real job market data (10+ languages)
• Salary analysis & benchmarking
• Growth rate tracking
• Company hiring information
• Career progression paths
• Opportunity scoring
• Weekly market reports

Trending Digest Component 🆕

• 📊 Multi-Language Trending - Top 15 repos per language weekly
• 🤖 AI/ML Detection - Identifies latest AI projects (40+ keywords)
• 💼 Job Market Correlation - Shows salary, demand, growth per language
• 🚀 Smart Recommendations - How to get started with trending tech
• 📰 Newsletter Generation - Beautiful formatted markdown reports
• 💬 Slack Integration - Automatic weekly posts to Slack channel
• 📈 Statistics & Insights - Market analysis and career guidance
• 📁 JSON Export - Complete data export for further analysis
• ⏰ Ready for Automation - Windows Task Scheduler, GitHub Actions ready
• 🔗 Integrations - Examples for Discord, Email, Database included

🔒 Security

✅ GitHub token stored in environment variables (not in code)
✅ .gitignore configured to prevent secrets
✅ No credentials in documentation
✅ Secure HTTPS connections

🤝 Contributing

Want to improve or add features?

→ See CONTRIBUTING.md

How to Contribute:

1. Fork the repository
2. Create feature branch: git checkout -b feature/your-feature
3. Make changes (update code & docs)
4. Commit: git commit -m "feat: describe change"
5. Push and create pull request

❓ FAQ

Q: Do I need both components?
A: No! Use just the one you need. They work independently.

Q: How do I extend with my own agent?
A: Follow the component structure. See CONTRIBUTING.md.

Q: Is my GitHub token safe?
A: Yes! It's stored locally in environment variables, never in code.

Q: Can I use this commercially?
A: Yes! MIT license allows commercial use. See LICENSE.

Q: How often is job market data updated?
A: Manually updated (2024-2025 stats). We recommend running monthly for trends.

🌟 What's Inside

Source Code

github-mcp/src/agent.js                      ~300 lines   ✅ Clean & documented
job-analyzer/src/job-market-analyzer.js      ~500 lines   ✅ Rich features
trending-digest/src/trending-digest.js       ~600 lines   ✅ Fully featured 🆕

Documentation

20+ documentation files
70+ pages total
40+ code examples
5+ architecture diagrams
20+ FAQ entries
Complete setup guides
Slack integration guide

🚀 Next Steps

1. Start with one component - Pick GitHub MCP OR Job Analyzer
2. Run locally - npm start or npm run job-market
3. Explore examples - See component docs/EXAMPLES.md
4. Customize - Modify for your needs
5. Extend - Build your own agents
6. Share - Contribute back to the project

📞 Support

Problem? Check these:

• 📖 Specific component README or job-analyzer/
• 🔧 INSTALLATION.md
• 🆘 TROUBLESHOOTING.md
• 📋 ENVIRONMENT_SETUP.md

Want to help? → CONTRIBUTING.md

📜 License

MIT License © 2024-2026
See LICENSE for details.

🌍 Ready to Explore?

Choose your path:

🔗 GitHub MCP          →  [github-mcp/README.md](github-mcp/README.md)
                           Automate GitHub & integrate with AI

💼 Job Analyzer        →  [job-analyzer/README.md](job-analyzer/README.md)
                           Understand tech market & career paths

📈 Trending Digest     →  [trending-digest/README.md](trending-digest/README.md)
                           Weekly digest of trends + Slack integration 🆕

📚 Full Docs           →  [docs/](docs/)
                           Everything you need to know

Built with ❤️ for developers who want to automate with AI

🚀 Start: npm start
📊 Analyze: npm run job-market
📈 Discover: npm run trending-digest