Awesome Copilot MCP Server

Awesome Copilot MCP 服务

一个模型上下文协议（MCP）服务，用于访问 awesome-copilot Agent 和集合资源。

快速开始

一键安装到 VS Code

点击徽章即可直接安装到 VS Code（系统会提示打开 VS Code）：

**注意：**需要在 VS Code 中安装 GitHub Copilot 扩展。点击 GitHub 上的徽章即可触发安装提示。

手动配置

将以下内容添加到 MCP 客户端配置中（例如 Claude Desktop 或 VS Code）：

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

这样可以确保始终运行最新版本。

用法

作为 MCP 服务

标准 stdio 用法（默认）。请参阅上方的配置。

作为 HTTP / OpenAPI 服务

在本地运行，以便远程访问或测试 OpenAPI：

npx -y awesome-copilot-mcp start-http --port 8080 --host 0.0.0.0

可用端点：

• GET /health 健康检查
• GET /metadata 返回元数据索引
• GET /metadata/stream 以 SSE 流式输出元数据
• GET /search?q=kw 搜索
• GET /openapi.json API 文档

支持的内容类型

此服务现已为官方 github/awesome-copilot 仓库中发布的所有资源编制索引：

• 🤖 Agent
• 💬 提示词
• 📋 说明
• 🛠️ 技能（支持文件夹识别）
• 📦 集合
• 🎁 插件（来自 plugins/external.json）
• 🪝 钩子
• ⚡ Agentic 工作流

调试

推荐使用 MCP Inspector 进行测试和调试：

# Debug via Stdio (Recommended)
npx -y awesome-copilot-mcp debug --no-build

# Debug via HTTP
npm run inspect:http

架构

此服务采用捆绑式 + 内存架构，以实现最高可靠性：

1. 启动：加载直接打包在 npm 软件包中的 metadata.json。无需外部依赖。
2. 热更新：refresh_metadata 从 GitHub 获取最新数据，并将其存储在当前会话的内存中。
3. 沙盒友好：不使用本地磁盘缓存（~/.cache），避免在受限环境（例如 macOS App Sandbox）中出现权限问题。

环境变量

变量	描述
ACP_METADATA_URL	可选。托管的 metadata.json 的 URL（例如 https://yourname.github.io/repo/metadata.json）。将覆盖 GitHub 原始文件的获取地址。
ACP_REPOS_JSON	自定义仓库配置 JSON。

元数据生成

自动化：GitHub Actions 每天运行一次，从 github/awesome-copilot 获取最新元数据，并在检测到更改时发布新的 npm 版本。

内部机制： 元数据文件体积小（约 170 KB），仅包含索引信息。Agent、提示词、说明、技能、集合、插件、钩子和工作流的实际内容及下载目标，会通过公开的工具和资源按需解析。

开发

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

许可证

MIT