Awesome Copilot MCP

🚀 超棒的Copilot MCP服务器

这是一个模型上下文协议（MCP）服务器，可提供对 超棒的Copilot 代理和集合资源的访问。

🚀 快速开始

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文档

🔧 调试

建议使用MCP Inspector进行测试和调试：

# 通过Stdio调试（推荐）
npx -y awesome-copilot-mcp debug --no-build

# 通过HTTP调试
npm run inspect:http

🔧 技术细节

此服务器使用 捆绑 + 内存中 架构以实现最大可靠性：

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

📚 详细文档

环境变量

元数据生成

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

内部机制： 元数据文件很轻量级（约170 KB），仅包含索引信息。实际内容（代理说明、提示）通过 download 工具按需获取。

开发

# 安装依赖
npm install

# 构建
npm run build

# 运行测试
npm test

📄 许可证

本项目采用MIT许可证。