English Français العربية

Awesome Copilot MCP Server

Official registry AI and agents

Model Context Protocol server for awesome-copilot agents and collections

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package awesome-copilot-mcp
Claude Code 
claude mcp add awesome-copilot-mcp-server -- npx -y awesome-copilot-mcp@0.8.7
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "awesome-copilot-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "awesome-copilot-mcp@0.8.7"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Awesome Copilot MCP Server
  2. Quick Start
  3. Usage
  4. Debugging
  5. Architecture
  6. Environment Variables
  7. Metadata Generation
  8. Development
  9. License

Awesome Copilot MCP Server

A Model Context Protocol (MCP) server that provides access to awesome-copilot agents and collection resources.

Quick Start

One-Click Installation for VS Code

Click the badge to install directly in VS Code (will prompt to open VS Code):

Note: Requires GitHub Copilot extension in VS Code. Click the badge on GitHub to trigger the installation prompt.

Manual Configuration

Add to your MCP Client configuration (e.g., Claude Desktop or VS Code):

{
  "mcpServers": {
    "awesome-copilot": {
      "command": "npx",
      "args": ["-y", "awesome-copilot-mcp", "start"]
    }
  }
}

This ensures you always run the latest version.

Usage

As MCP Server

Standard stdio usage (default). See configuration above.

As HTTP / OpenAPI Server

Run locally for remote access or OpenAPI testing:

npx -y awesome-copilot-mcp start-http --port 8080 --host 0.0.0.0

Available endpoints:

  • GET /health Health check
  • GET /metadata Return metadata index
  • GET /metadata/stream SSE streaming output of metadata
  • GET /search?q=kw Search
  • GET /openapi.json API Documentation
Supported Content Types

This server now indexes all resources published in the official github/awesome-copilot repository:

  • 🤖 Agents
  • 💬 Prompts
  • 📋 Instructions
  • 🛠️ Skills (folder-aware)
  • 📦 Collections
  • 🎁 Plugins (from plugins/external.json)
  • 🪝 Hooks
  • ⚡ Agentic Workflows

Debugging

MCP Inspector is the recommended way to test and debug:

# Debug via Stdio (Recommended)
npx -y awesome-copilot-mcp debug --no-build

# Debug via HTTP
npm run inspect:http

Architecture

This server uses a Bundled + In-Memory architecture for maximum reliability:

  1. Startup: Loads metadata.json bundled directly within the npm package. Zero external dependencies.
  2. Hot Updates: refresh_metadata fetches the latest data from GitHub and stores it in memory for the current session.
  3. Sandbox Friendly: No local disk cache (~/.cache) is used, preventing permission issues in restricted environments (e.g., macOS App Sandbox).

Environment Variables

VariableDescription
ACP_METADATA_URLOptional. URL to a hosted metadata.json (e.g. https://yourname.github.io/repo/metadata.json). Overrides GitHub raw fetch.
ACP_REPOS_JSONCustom repository configuration JSON.

Metadata Generation

Automated: GitHub Actions runs daily to fetch the latest metadata from github/awesome-copilot and publishes a new npm version if changes are detected.

Internal: The metadata file is lightweight (~170 KB) containing only index info. Actual content and download targets for agents, prompts, instructions, skills, collections, plugins, hooks, and workflows are resolved on-demand via the exposed tools and resources.

Development

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

License

MIT

Frequently asked questions

What is Awesome Copilot MCP Server?

Model Context Protocol server for awesome-copilot agents and collections

How do I install Awesome Copilot MCP Server?

It runs on your machine. In Claude Code: claude mcp add awesome-copilot-mcp-server -- npx -y awesome-copilot-mcp@0.8.7. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Awesome Copilot MCP Server need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Awesome Copilot MCP Server open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Awesome Copilot MCP Server?

It is published by RbBtSn0w. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.