MCP Servers

A collection of Model Context Protocol servers, templates, tools and more.

M
MCP Github Agents
by @Abteeeen
GitHub Repo(1 stars)

GitHub MCP + AI Agents Framework

Created 3/6/2026
Updated about 11 hours ago
README
View Source
Repository documentation and setup instructions

🚀 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

License: MIT Node.js Agents: 3 Slack: Ready

🎯 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

For Job Analyzer

For Trending Digest 🆕

Shared Documentation

🎓 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:

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
Quick Setup
Installation guide for this server

Install Package (if required)

npx @modelcontextprotocol/server-mcp-github-agents

Cursor configuration (mcp.json)

{ "mcpServers": { "abteeeen-mcp-github-agents": { "command": "npx", "args": [ "abteeeen-mcp-github-agents" ] } } }