English Français العربية

Awesome Copilot MCP Server

السجل الرسمي الذكاء الاصطناعي والوكلاء

Model Context Protocol server for awesome-copilot agents and collections

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو Awesome Copilot MCP Server؟

Model Context Protocol server for awesome-copilot agents and collections

كيف أثبّت Awesome Copilot MCP Server؟

يعمل على جهازك. في Claude Code: claude mcp add awesome-copilot-mcp-server -- npx -y awesome-copilot-mcp@0.8.7. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Awesome Copilot MCP Server إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Awesome Copilot MCP Server مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Awesome Copilot MCP Server؟

ينشره RbBtSn0w. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.