Awesome Copilot MCP Server
Model Context Protocol server for awesome-copilot agents and collections
Open source Open in the app JSON README (API)
About
Model Context Protocol server for awesome-copilot agents and collections
Details
- Kind
- MCP servers
- Topic
- AI, RAG & memory
- Publisher
- rbbtsn0w
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.8.6
- Stars
- 3
- Forks
- 1
- Open pull requests
- 1
- Last push
- 2026-09-03T06:34:15Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:02:11
- Updated
- 2026-08-29 03:02:11
- Origin id
io.github.RbBtSn0w/awesome-copilot-mcp
README
# Awesome Copilot MCP Server
[](https://www.npmjs.com/package/awesome-copilot-mcp)
[](https://opensource.org/licenses/MIT)
[](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):
[](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) [](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