# Awesome Copilot MCP Server

**Category:** 🤖 Coding Agents  
**Repository:** https://github.com/RbBtSn0w/awesome-copilot-mcp  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/awesome-copilot-mcp-server

## Description
Model Context Protocol server for awesome-copilot agents and collections

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

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

## Documentation & README

# Awesome Copilot MCP Server

[![npm version](https://img.shields.io/npm/v/awesome-copilot-mcp)](https://www.npmjs.com/package/awesome-copilot-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Build Status](https://github.com/RbBtSn0w/awesome-copilot-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/RbBtSn0w/awesome-copilot-mcp/actions)

A Model Context Protocol (MCP) server that provides access to [awesome-copilot](https://github.com/github/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):

[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_awesome--copilot-0098FF?style=flat-square&logo=visualstudiocode&logoColor=ffffff)](https://vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3Fconfig%3D%7B%22name%22%3A%22awesome-copilot%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22awesome-copilot-mcp%22%2C%22start%22%5D%7D) [![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_awesome--copilot-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=ffffff)](https://vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3Fconfig%3D%7B%22name%22%3A%22awesome-copilot%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22awesome-copilot-mcp%22%2C%22start%22%5D%7D)

> **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):

```json
{
  "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:

```bash
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:

```bash
# 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

| Variable | Description |
|----------|-------------|
| `ACP_METADATA_URL` | Optional. URL to a hosted `metadata.json` (e.g. `https://yourname.github.io/repo/metadata.json`). Overrides GitHub raw fetch. |
| `ACP_REPOS_JSON` | Custom 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

```bash
# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test
```

## License

MIT