🌟 What Makes This Special

Transform your GitHub workflow from point-and-click to conversation-driven development! This repository contains 91 structured exercises that teach you to use MCP-capable assistants (like GitHub Copilot Chat) for every aspect of GitHub project management.

🎯 Perfect For

• Developers seeking step-by-step labs for repository, branch, issue, PR, and Actions workflows
• Team Leads & Instructors building hands-on training or onboarding workshops
• Open-Source Maintainers wanting reproducible contributor guidance curricula

✨ What You'll Master

| Category | Tools | Skills | |----------|-------|--------| | 🏗️ Repository Management | 15 tools | Creation, settings, collaboration | | 🌿 Branch Operations | 12 tools | Feature branches, protection rules | | 🐛 Issues & Tracking | 18 tools | Bug reports, labels, milestones | | 🔄 Pull Requests | 16 tools | Code review, approval workflows | | 📁 File Management | 10 tools | Content operations, directory structure | | 📊 Commits & History | 8 tools | Version tracking, comparisons | | 🏷️ Releases & Tags | 6 tools | Version management, deployments | | ⚡ Actions & Workflows | 6 tools | CI/CD automation |

🚀 Quick Start

# 1. Clone this repository
git clone https://github.com/hereandnowai/vscode-mcp-tools-guide.git

# 2. Open in VS Code
code vscode-mcp-tools-guide

# 3. Install GitHub Copilot Chat extension (or your preferred MCP client)

# 4. Configure your MCP connection in .vscode/mcp.json

📋 Prerequisites

• GitHub account with appropriate permissions
• VS Code with GitHub Copilot Chat extension
• MCP server configuration

📚 Learning Path

🎓 Beginner Level (Tools 1-30)

Start with repository basics and simple operations

• Repository creation and management
• Basic file operations
• Simple issue tracking

🔧 Intermediate Level (Tools 31-60)

Master collaboration workflows

• Pull request management
• Branch strategies
• Code review processes

🚀 Advanced Level (Tools 61-91)

Automate and scale your workflows

• Complex automation scenarios
• CI/CD pipeline integration
• Team collaboration patterns

📖 Key Resources

| File | Purpose | |------|---------| | 📘 gh-mcp-tools.md | Main guide - Complete activities and scenarios | | ⚙️ .vscode/mcp.json | Configuration - Sample MCP client setup | | 🎨 branding.json | Assets - Organization branding and contact info |

🎨 Brand Identity

🏢 About HERE AND NOW AI

🤝 Contributing

We welcome contributions! Here's how you can help:

• 🐛 Report Issues - Found a problem? Let us know!
• 💡 Suggest Improvements - Have ideas for better exercises?
• 📖 Improve Documentation - Help make the guide clearer
• ✨ Add Examples - Share your own MCP workflow scenarios

Please open a pull request with your changes and a description of the improvement.

📄 License

This repository is licensed under the MIT License — see the LICENSE file for details.

A practical learning and reference repository for using GitHub's MCP-enabled tools from inside Visual Studio Code. This project collects guided exercises, example workflows, and reference material so developers, maintainers, and instructors can learn how to use MCP tooling in real tasks — without expecting the reader to already know every MCP API call.

Who this is for

• Developers who want step-by-step labs to practice repository, branch, issue, PR, file, commit, release, and Actions workflows via MCP-enabled assistants.
• Team leads and instructors building hands-on training or onboarding workshops.
• Open-source maintainers who want a reproducible curriculum for contributor guidance.

What you'll find here

• A curated set of hands-on activities and exercises (beginner → advanced) that demonstrate common GitHub tasks using MCP-capable assistant tooling.
• A single reference document (gh-mcp-tools.md) with scenarios and suggested commands/steps.
• An example MCP client configuration under .vscode/mcp.json to get VS Code assistants talking to a configured MCP server.
• branding.json with organization assets and contact information used to brand the guide and any generated documentation.

Quick start

1. Open this folder in VS Code.
2. Install the GitHub Copilot Chat extension (or whichever MCP client you use).
3. Verify or create .vscode/mcp.json with your MCP server details.
4. Read gh-mcp-tools.md for the full list of activities and a suggested learning path.

Structure and suggested learning path

• Start with the Repository and Branch Management sections to learn basic operations and protections.
• Move to Issues and Pull Requests to practice lifecycle and review flows.
• Finish with Actions, Releases, and Advanced Scenarios to automate and scale workflows.

Branding and visual notes

• Logo and contact: pulled from branding.json to make the repo immediately identifiable and to give contributors the right contact points.
• Brand colors: Primary #FFDF00 and Secondary #004040 are included as a reference for anyone producing visuals or docs derived from this repository. They are not meant to be enforced by code — they exist to help maintain a consistent visual identity for any generated slides, web pages, or tutorial PDFs. Including the colors in this README makes them easy for contributors to find when they produce collateral.

Files you should look at first

• gh-mcp-tools.md — primary guide and activities (read this to understand the exercises and learning objectives).
• .vscode/mcp.json — sample MCP configuration used by the VS Code assistant.
• branding.json — organization metadata (logo, contact, social links) used in this repository's docs.

Contributing and contact

• If you want to extend or reorganize the exercises, open a pull request with your changes and a short explanation.
• For questions about HERE AND NOW AI branding or the guide itself, contact: info@hereandnowai.com

Why the README is styled this way

• The goal is to make the repository approachable: a short description, clear audience, quick start steps, and where to go next (the longer gh-mcp-tools.md file). Branding elements are included to provide identity and contact info for contributors.

HERE AND NOW AI — designed with passion for innovation Website: https://hereandnowai.com GitHub: https://github.com/hereandnowai