Awesome Agent Skills MCP

🚀 超棒的代理技能MCP服务器

这是一个模型上下文协议（MCP）服务器，可访问来自 VoltAgent超棒代理技能 集合的100多种精心策划的AI代理技能。借助来自Anthropic、Vercel、Trail of Bits、Hugging Face、Stripe、Expo等众多领先组织的技能，将你的AI助手转变为专业专家。

🚀 快速开始

npx awesome-agent-skills-mcp

就是这么简单！将其添加到你的MCP客户端配置中，即可开始使用100多种AI技能。

✨ 主要特性

• 100多种精心策划的技能：可访问来自Anthropic、Vercel、Trail of Bits、Hugging Face等顶级组织的技能。
• 自动同步：自动从VoltAgent仓库获取并更新技能。
• 符合MCP 2024 - 11 - 05标准：与最新的模型上下文协议规范完全兼容。
• 多客户端支持：可与Claude、GitHub Copilot、OpenCode以及任何兼容MCP的客户端配合使用。
• 智能缓存：基于高效的JSON缓存，实现快速启动。
• 类型安全：使用TypeScript和Zod构建，进行运行时验证。
• 零配置：使用合理的默认设置，开箱即用。

📦 安装指南

前提条件

• Node.js >= 20.0.0
• npm 或 yarn

从npm安装

npm install awesome-agent-skills-mcp

从源代码安装

git clone https://github.com/shadowrootdev/awesome-agent-skills-mcp.git
cd awesome-agent-skills-mcp
npm install
npm run build

💻 使用示例

在GitHub Copilot Chat中

@workspace Use the react-best-practices skill to review my React components

@workspace List all available security-related skills

@workspace Get the stripe-best-practices skill and apply it to my checkout code

在Claude中

What skills are available for Next.js development?

Use the code-review skill to analyze my pull request

📚 详细文档

配置

VS Code / GitHub Copilot

在项目中创建或更新 .vscode/mcp.json：

{
  "servers": {
    "awesome-agent-skills": {
      "command": "npx",
      "args": ["awesome-agent-skills-mcp"]
    }
  }
}

或者使用本地安装的配置：

{
  "servers": {
    "awesome-agent-skills": {
      "command": "node",
      "args": ["/path/to/awesome-agent-skills-mcp/dist/index.js"]
    }
  }
}

⚠️ 重要提示

添加配置后，完全退出VS Code（Cmd + Q / Alt + F4）并重新打开，更改才能生效。

Claude Desktop

在Claude Desktop配置文件（macOS上为 ~/Library/Application Support/Claude/claude_desktop_config.json）中添加：

{
  "mcpServers": {
    "awesome-agent-skills": {
      "command": "npx",
      "args": ["awesome-agent-skills-mcp"]
    }
  }
}

OpenCode

在 ~/.config/opencode/opencode.json 中添加：

{
  "mcp": {
    "awesome-agent-skills": {
      "type": "local",
      "command": ["npx", "awesome-agent-skills-mcp"],
      "enabled": true
    }
  }
}

环境变量

可用技能

服务器提供来自领先组织的 100多种技能：

Anthropic

文档处理、演示文稿创建、电子表格操作、PDF处理、算法艺术、MCP构建等。

Vercel

React和Next.js最佳实践、部署和性能优化。

Trail of Bits

安全分析、智能合约审计和代码审查工具。

Hugging Face

ML模型训练、数据集管理和Hub操作。

Sentry

代码审查、提交约定和PR自动化。

还有更多...

• Stripe - 支付集成最佳实践
• Expo - React Native应用开发
• n8n - 工作流自动化模式
• Sanity - CMS最佳实践
• Neon - 无服务器Postgres
• Remotion - 程序化视频创建

MCP工具

服务器提供四个MCP工具：

list_skills

列出所有可用技能，可进行可选过滤。

// 列出所有技能
{ }

// 按来源过滤
{ "source": "repository" }

// 按标签过滤
{ "tag": "security" }

get_skill

获取特定技能的详细信息。

{ "skill_id": "react-best-practices" }

invoke_skill

调用技能并可传入可选参数。

{
  "skill_id": "docx",
  "parameters": {
    "document_type": "report"
  }
}

refresh_skills

手动触发从仓库刷新技能。

{ }

🔧 技术细节

开发

环境搭建

git clone https://github.com/shadowrootdev/awesome-agent-skills-mcp.git
cd awesome-agent-skills-mcp
npm install

构建

npm run build

运行测试

# 运行所有测试
npm test

# 以监听模式运行测试
npm run test:watch

# 仅运行集成测试
npm run test:integration

代码检查和格式化

npm run lint
npm run format

项目结构

awesome-agent-skills-mcp/
├── src/
│   ├── index.ts              # 入口文件
│   ├── server.ts             # MCP服务器实现
│   ├── config.ts             # 配置管理
│   ├── models/
│   │   ├── skill.ts          # 技能类型定义
│   │   ├── parameter.ts      # 参数模式
│   │   ├── registry.ts       # 技能注册表类
│   │   └── repository.ts     # 仓库源模型
│   ├── services/
│   │   ├── git-sync.ts       # Git仓库同步
│   │   ├── skill-parser.ts   # 从README解析技能
│   │   └── skill-executor.ts # 技能调用
│   ├── cache/
│   │   └── cache-manager.ts  # 基于JSON的缓存
│   └── utils/
│       └── logger.ts         # 结构化日志记录
├── tests/
│   ├── unit/                 # 单元测试
│   └── integration/          # 集成测试
├── dist/                     # 编译输出
└── .cache/                   # 运行时缓存（已添加到.gitignore）

API参考

技能对象

interface Skill {
  id: string;           // 唯一标识符
  name: string;         // 显示名称
  description: string;  // 简短描述
  source: 'repository' | 'local';
  sourcePath: string;   // GitHub URL或本地路径
  content: string;      // 完整技能内容（Markdown格式）
  parameters: ParameterSchema[];
  metadata: {
    author?: string;
    version?: string;
    tags?: string[];
    requirements?: string[];
    sourceOrg?: string;   // GitHub组织
    sourceRepo?: string;  // GitHub仓库
  };
  lastUpdated: Date;
}

参数模式

interface ParameterSchema {
  name: string;
  type: 'string' | 'number' | 'boolean' | 'object' | 'array';
  description: string;
  required: boolean;
  default?: unknown;
  enum?: unknown[];
}

📄 许可证

本项目采用MIT许可证 - 详细信息请参阅 LICENSE 文件。

相关项目

• VoltAgent - AI代理框架
• 超棒的代理技能 - 源技能集合
• MCP服务器 - 官方MCP服务器实现

为AI代理社区用心打造
⭐ 给超棒的代理技能仓库点个星