Add MCPB Bundle Distribution Package

[troystaylor]

• Create portable .mcpb bundle for easy distribution
• Implement MCP server with search, load, and list tools
• Add installation instructions for Claude Desktop and VS Code
• Bundle size: 5.0MB compressed, 17.5MB unpacked
• Includes all agents, chatmodes, instructions, and prompts

Pull Request Checklist

• I have read and followed the CONTRIBUTING.md guidelines.
• My contribution adds a new instruction, prompt, or chat mode file in the correct directory.
• The file follows the required naming convention.
• The content is clearly structured and follows the example format.
• I have tested my instructions, prompt, or chat mode with GitHub Copilot.
• I have run npm start and verified that README.md is up to date.

---

Description

This PR introduces a portable MCPB (Model Context Protocol Bundle) distribution of the awesome-github-copilot repository, enabling easy installation and usage in Claude Desktop and VS Code.

---

Type of Contribution

• New instruction file.
• New prompt file.
• New chat mode file.
• New collection file.
• Update to existing instruction, prompt, chat mode, or collection.
• Other (please specify): MCPB Bundle

---

Additional Notes

What's Included

• MCPB Bundle: Portable .mcpb file (5.0MB compressed, 17.5MB unpacked)
• MCP Server: Node.js-based server implementing the Model Context Protocol with three tools:
  • search_instructions: Search across all agents, chatmodes, instructions, and prompts by keywords
  • load_instruction: Load full content of any file by mode and filename
  • list_files: List all available files by content type
• Installation Guide: Complete documentation for Claude Desktop (Windows/macOS/Linux) and VS Code
• Content: All 387 files (26 agents, 117 chatmodes, 129 instructions, 115 prompts, documentation)

Benefits

• One-Click Installation: Users can install the entire repository as an MCP server without manual git cloning
• Cross-Platform: Works on Windows, macOS, and Linux
• IDE Integration: Compatible with Claude Desktop and VS Code
• Easy Discovery: Search functionality makes it simple to find relevant agents, prompts, and instructions
• Portable: Single file distribution that includes all dependencies

Installation

Users can install by:

1. Downloading the .mcpb file from releases
2. Copying to $APPDATA/Claude/mcpb/ (Windows) or equivalent
3. Restarting Claude Desktop

For VS Code, one-click installation is available via the provided vscode:// URL.

Testing

• Bundle creation validated
• Manifest schema passes validation
• MCP server responds correctly to tool calls
• Successfully tested in Claude Desktop
• All dependencies installed (87 packages, 0 vulnerabilities)

Files Changed

• mcpb-bundle/: New directory containing the entire distribution package
• mcpb-bundle/awesome-copilot-1.0.0.mcpb: Production bundle
• mcpb-bundle/README-BUNDLE.md: User installation guide
• mcpb-bundle/build/: Server implementation and dependencies

This provides an alternative distribution method alongside the existing repository clone workflow, making it easier for users to integrate awesome-github-copilot content into their AI-assisted development environment.

---

By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

[Copilot]

Pull request overview

This PR introduces a portable MCPB (Model Context Protocol Bundle) distribution package for the awesome-copilot repository, enabling one-click installation of all agents, chatmodes, instructions, and prompts as an MCP server for Claude Desktop and VS Code.

Key Changes:

• Creates a bundled MCP server implementation with search, load, and list tools for accessing repository content
• Adds comprehensive installation documentation for Windows, macOS, Linux, and VS Code
• Packages 387 files (26 agents, 117 chatmodes, 129 instructions, 115 prompts) into a 5.0MB compressed bundle

Reviewed changes

Copilot reviewed 87 out of 372 changed files in this pull request and generated 1 comment.

File	Description
mcpb-bundle/build/package.json	Node.js package configuration for the MCP server with dependencies
mcpb-bundle/chatmodes/*.chatmode.md	Multiple chatmode files defining AI assistant behaviors for various domains

---

Files not reviewed (1)

• mcpb-bundle/build/package-lock.json: Language not supported

[aaronpowell]

While I appreciate the intent of this PR, I'm going to close it.

Talking with the Copilot folks, MCPB is something that is top of mind for them especially with the position it'll play in the MCP spec and how that relates to the repository, so we need to think through a design that works will with that.

Additionally, this PR is very much a one-shot design, whereas if we are going to be shipping MCPB files I want to think through the practicalities of it. Having the MCPB file in the git repo isn't ideal as it adds a huge amount of weight to the repo (binary files don't pack well!). We also need to have a process which sees it update seamlessly (this PR looks to essentially clone the whole repo contents into a new folder which isn't exactly practical) and publish the updates for consumption when things change. Lastly, we need to look at the relationship that MCPB has with our current MCP server - can we leverage the code in there, does it replace it, is it a companion, etc.

I'll spend some time on this and spin up an issue for the design.

[troystaylor]

Completely understand, I just wanted to get the idea out there.