{
  "markdown": "# Awesome Copilot MCP Server\n\n[![npm version](https://img.shields.io/npm/v/awesome-copilot-mcp)](https://www.npmjs.com/package/awesome-copilot-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Build Status](https://github.com/RbBtSn0w/awesome-copilot-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/RbBtSn0w/awesome-copilot-mcp/actions)\n\nA Model Context Protocol (MCP) server that provides access to [awesome-copilot](https://github.com/github/awesome-copilot) agents and collection resources.\n\n## Quick Start\n\n### One-Click Installation for VS Code\n\nClick the badge to install directly in VS Code (will prompt to open VS Code):\n\n[![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)\n\n> **Note:** Requires GitHub Copilot extension in VS Code. Click the badge on GitHub to trigger the installation prompt.\n\n### Manual Configuration\n\nAdd to your MCP Client configuration (e.g., Claude Desktop or VS Code):\n\n```json\n{\n  \"mcpServers\": {\n    \"awesome-copilot\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"awesome-copilot-mcp\", \"start\"]\n    }\n  }\n}\n```\n\nThis ensures you always run the latest version.\n\n## Usage\n\n### As MCP Server\n\nStandard stdio usage (default). See configuration above.\n\n### As HTTP / OpenAPI Server\n\nRun locally for remote access or OpenAPI testing:\n\n```bash\nnpx -y awesome-copilot-mcp start-http --port 8080 --host 0.0.0.0\n```\n\nAvailable endpoints:\n- `GET /health` Health check\n- `GET /metadata` Return metadata index\n- `GET /metadata/stream` SSE streaming output of metadata\n- `GET /search?q=kw` Search\n- `GET /openapi.json` API Documentation\n\n### Supported Content Types\n\nThis server now indexes all resources published in the official `github/awesome-copilot` repository:\n\n- 🤖 Agents\n- 💬 Prompts\n- 📋 Instructions\n- 🛠️ Skills (folder-aware)\n- 📦 Collections\n- 🎁 Plugins (from `plugins/external.json`)\n- 🪝 Hooks\n- ⚡ Agentic Workflows\n\n## Debugging\n\nMCP Inspector is the recommended way to test and debug:\n\n```bash\n# Debug via Stdio (Recommended)\nnpx -y awesome-copilot-mcp debug --no-build\n\n# Debug via HTTP\nnpm run inspect:http\n```\n\n## Architecture\n\nThis server uses a **Bundled + In-Memory** architecture for maximum reliability:\n1. **Startup**: Loads `metadata.json` bundled directly within the npm package. Zero external dependencies.\n2. **Hot Updates**: `refresh_metadata` fetches the latest data from GitHub and stores it in **memory** for the current session.\n3. **Sandbox Friendly**: No local disk cache (`~/.cache`) is used, preventing permission issues in restricted environments (e.g., macOS App Sandbox).\n\n## Environment Variables\n\n| Variable | Description |\n|----------|-------------|\n| `ACP_METADATA_URL` | Optional. URL to a hosted `metadata.json` (e.g. `https://yourname.github.io/repo/metadata.json`). Overrides GitHub raw fetch. |\n| `ACP_REPOS_JSON` | Custom repository configuration JSON. |\n\n## Metadata Generation\n\n**Automated**: GitHub Actions runs daily to fetch the latest metadata from `github/awesome-copilot` and publishes a new npm version if changes are detected.\n\n**Internal**:\nThe 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.\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run tests\nnpm test\n```\n\n## License\n\nMIT\n\n",
  "bytes": 4236,
  "sha": "b10340f03c06cfa0fd9e4c845e3738e0d9e1e8763b0ecf94e03b2ad69b73ab28",
  "repo_slug": "rbbtsn0w/awesome-copilot-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_rbbtsn0w_awesome_copilot_mcp_d054079c/readme"
}