使用说明

出色的代理技能MCP服务器

模型上下文协议（MCP）服务器，提供对100多种精心策划的AI代理技能的访问 VoltAgent出色的代理技能收藏。

将您的人工智能助手转变为具有Anthropic、Vercel、Trail of Bits、Hugging Face、Stripe、Expo等众多领先组织技能的专业专家。

🚀 快速开始

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构建，用于运行时验证
零配置 -使用合理的默认值即可开箱即用

快速开始

使用npx（推荐）

npx awesome-agent-skills-mcp

全球安装

npm install -g awesome-agent-skills-mcp
awesome-agent-skills-mcp

安装

先决条件

Node.js >= 20.0.0
npm 或纱线

来自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

配置

VS代码/GitHub副本

创建或更新 .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代码 （Cmd+Q/Alt+F4）并重新打开它以使更改生效。

克劳德桌面版

添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "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
    }
  }
}

环境变量

变量	默认值	描述
`SKILLS_REPO_URL`	`https://github.com/VoltAgent/awesome-agent-skills.git`	技能库URL
`SKILLS_CACHE_DIR`	`.cache`	缓存目录路径
`SKILLS_SYNC_INTERVAL`	`60`	自动同步间隔（分钟）（0表示禁用）
`LOG_LEVEL`	`info`	日志记录级别（调试、信息、警告、错误）

可用技能

服务器提供访问 100+技能 来自领先组织：

Anthropic

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

技能	描述
`docx`	创建、编辑和分析Word文档
`pptx`	PowerPoint演示文稿的创建和编辑
`xlsx`	使用公式操作电子表格
`pdf`	PDF处理和表格填写
`mcp-builder`	创建MCP服务器指南
`webapp-testing`	基于Playwright的web应用程序测试

维塞尔

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

技能	描述
`react-best-practices`	React性能优化指南
`next-best-practices`	Next.js约定和模式
`web-design-guidelines`	UI/UX合规性审查
`vercel-deploy`	将应用程序部署到Vercel

比特的踪迹

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

技能	描述
`building-secure-contracts`	智能合约安全工具包
`semgrep-rule-creator`	创建自定义Semgrep规则
`property-based-testing`	基于属性的测试指南
`static-analysis`	静态分析工具

拥抱脸

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

技能	描述
`hugging-face-cli`	HF Hub CLI操作
`hugging-face-datasets`	数据集创建和管理
`hugging-face-model-trainer`	使用TRL进行模型微调
`hugging-face-evaluation`	模型评估工作流程

哨兵

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

技能	描述
`code-review`	哨兵工程规范审查实践
`commit`	常规提交消息
`create-pr`	遵循Sentry惯例的公关创作
`find-bugs`	Bug和漏洞检测

还有更多。..

条纹 -支付集成最佳实践
博览会 -React Native应用程序开发
n8n -工作流自动化模式
理智 -CMS最佳实践
霓虹 -无服务器Postgres
远程动议 -程序化视频创建

MCP工具

服务器公开了四个MCP工具：

`list_skills`

使用可选筛选列出所有可用技能。

// List all skills
{ }

// Filter by source
{ "source": "repository" }

// Filter by tag
{ "tag": "security" }

`get_skill`

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

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

`invoke_skill`

使用可选参数调用技能。

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

`refresh_skills`

从存储库手动触发技能刷新。

{ }

用法示例

在GitHub上进行Copilot聊天

@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

在克劳德

What skills are available for Next.js development?

Use the code-review skill to analyze my pull request

发展

设置

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

构建

npm run build

运行测试

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Run integration tests only
npm run test:integration

棉绒和格式

npm run lint
npm run format

项目结构

awesome-agent-skills-mcp/
├── src/
│   ├── index.ts              # Entry point
│   ├── server.ts             # MCP server implementation
│   ├── config.ts             # Configuration management
│   ├── models/
│   │   ├── skill.ts          # Skill type definitions
│   │   ├── parameter.ts      # Parameter schemas
│   │   ├── registry.ts       # SkillRegistry class
│   │   └── repository.ts     # Repository source model
│   ├── services/
│   │   ├── git-sync.ts       # Git repository sync
│   │   ├── skill-parser.ts   # Skill parsing from README
│   │   └── skill-executor.ts # Skill invocation
│   ├── cache/
│   │   └── cache-manager.ts  # JSON-based caching
│   └── utils/
│       └── logger.ts         # Structured logging
├── tests/
│   ├── unit/                 # Unit tests
│   └── integration/          # Integration tests
├── dist/                     # Compiled output
└── .cache/                   # Runtime cache (gitignored)

api参考

技能对象

interface Skill {
  id: string;           // Unique identifier
  name: string;         // Display name
  description: string;  // Short description
  source: 'repository' | 'local';
  sourcePath: string;   // GitHub URL or local path
  content: string;      // Full skill content (markdown)
  parameters: ParameterSchema[];
  metadata: {
    author?: string;
    version?: string;
    tags?: string[];
    requirements?: string[];
    sourceOrg?: string;   // GitHub organization
    sourceRepo?: string;  // GitHub repository
  };
  lastUpdated: Date;
}

参数架构

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

故障排除

技能未加载

检查缓存：删除 .cache 目录并重新启动
验证网络：确保访问GitHub
检查日志：设置 LOG_LEVEL=debug 用于详细输出

GitHub复制人看不见技能

需要完全重新启动：完全退出VS代码（Cmd+Q）并重新打开
检查配置路径：确保 .vscode/mcp.json 位于工作区根目录中
验证服务器：运行 npx awesome-agent-skills-mcp 手动测试

连接错误

# Test the server manually
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}' | npx awesome-agent-skills-mcp

学分

这个项目建立在开源社区令人难以置信的工作之上：

数据源

VoltAgent出色的代理技能 -VoltAgent维护的人工智能代理技能精选集。此MCP服务器从该存储库获取并提供技能，使MCP兼容的AI助手可以访问这些技能。

技能贡献者

本系列中的技能由领先组织贡献，包括：

Anthropic -文档处理、艺术生成、MCP构建
维塞尔 -React、Next.js、部署
比特的踪迹 -安全分析、智能合约
拥抱脸 -机器学习工作流程、模型训练
哨兵 -代码审查、提交约定
博览会 -React原生开发
条纹 -支付集成
还有更多的贡献者！

技术

模型上下文协议 -协议规范
@模型上下文协议/sdk -TypeScript官方SDK
黄道带 -TypeScript第一模式验证
简单git -Git操作

贡献

欢迎投稿！请阅读我们的贡献指南在提交PR之前。

克隆该仓库
创建功能分支(git checkout -b feature/amazing-feature)
提交您的更改(git commit -m 'Add amazing feature')
推到分支(git push origin feature/amazing-feature)
打开拉取请求

查看我们的问题模板用于报告错误、请求功能或提问。

文档和演示

GitHub页面

您可以启用GitHub Pages来托管交互式文档或演示：

创建文档 （推荐：使用 /docs 文件夹）：
- 创建 docs/ 存储库根目录中的目录
- 添加一个 index.html 文件或使用静态站点生成器，如VitePress或Docusaurus
- 这使得文档与源代码分开
启用GitHub页面:
- 转到您的存储库设置 → 页面
- 选择源：从分支部署
- 选择分支: main 和文件夹 /docs （推荐）或 / 如果部署整个仓库
- 保存并等待部署

这有助于：

交互式API文档
MCP服务器功能的现场演示
教程演练
技能目录浏览器

备注：使用 /docs 建议使用文件夹，因为它可以组织文档并将其与源代码分开。仅限使用 / （root），如果您想将整个存储库部署为网站。

许可证

此项目根据MIT许可证获得许可-请参阅许可证文件以获取详细信息。