MBS MCP Server: mbs-copilot-devcontext (aka Awesome Copilot)

This is an MCP server that retrieves GitHub Copilot customizations from the mbs-copilot-devcontext repository.

Install

Prerequisites

• .NET 9 SDK
• Visual Studio Code with
  • C# Dev Kit extension
• Azure CLI
• Azure Developer CLI
• Docker Desktop
• GitHub Personal Access Token - Required for accessing the awesome-copilot repository via GitHub API

What's Included

Awesome Copilot MCP server includes:

| Building Block | Name | Description | Usage | |----------------|-----------------------|-----------------------------------------------------------------------|------------------------------------------| | Tools | search_instructions | Searches custom instructions based on keywords in their descriptions. | #search_instructions | | Tools | load_instruction | Loads a custom instruction from the repository. | #load_instruction | | Prompts | get_search_prompt | Get a prompt for searching copilot instructions. | /mcp.awesome-copilot.get_search_prompt |

Getting Started

• Configuration
• Getting repository root
• Running MCP server
  • On a local machine
  • In a container
  • On Azure
• Connect MCP server to an MCP host/client
  • VS Code + Agent Mode + Local MCP server

Configuration

This MCP server uses the GitHub API to fetch custom instructions from the awesome-copilot repository. You need to configure a GitHub Personal Access Token to authenticate with the GitHub API.

GitHub Personal Access Token Setup

1. Go to GitHub Settings > Tokens
2. Click "Generate new token" (classic)
3. For public repositories: No special scopes are needed
4. For private repositories: Select the repo scope
5. Copy the generated token

Development Environment Setup

For local development, create a .env file in the src/McpSamples.AwesomeCopilot.HybridApp directory:

cd $REPOSITORY_ROOT/awesome-copilot/src/McpSamples.AwesomeCopilot.HybridApp
cp .env.example .env

Edit the .env file and add your GitHub token:

GITHUB__TOKEN=your_github_token_here

Security Note: The .env file is automatically ignored by git. Never commit your token to source control.

Production Environment Setup

For Docker containers and Azure deployments, pass the token as an environment variable (see respective sections below).

Optional Configuration

You can override the default repository settings using environment variables:

• GITHUB__REPOSITORYOWNER: Repository owner (default: github)
• GITHUB__REPOSITORYNAME: Repository name (default: awesome-copilot)
• GITHUB__BRANCH: Branch name (defa

... View full README on GitHub