Awesome Agent Skills MCP Server

出色的代理技能MCP服务器

   ](https://www.npmjs.com/package/awesome-agent-skills-mcp) ](https://www.npmjs.com/package/awesome-agent-skills-mcp)  ](https://nodejs.org)  ](https://github.com/shadowrootdev/awesome-agent-skills-mcp/releases) ](https://github.com/shadowrootdev/awesome-agent-skills-mcp/stargazers)

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

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

🚀 快速开始

npx awesome-agent-skills-mcp

就是这样！添加到您的MCP客户端配置中，开始使用100多种AI技能。

______________________________________________________________________

目录

• 特性
• 快速开始
• 安装
• 配置

- - 克劳德桌面版 - OpenCode

• 可用技能
• MCP工具
• 用法示例
• 发展
• api参考
• 故障排除
• 学分
• 许可证

______________________________________________________________________

特性

• 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
    }
  }
}

环境变量

______________________________________________________________________

可用技能

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

Anthropic

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

维塞尔

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

比特的踪迹

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

拥抱脸

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

哨兵

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

还有更多。..

• 条纹 -支付集成最佳实践
• 博览会 -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[];
}

______________________________________________________________________

故障排除

技能未加载

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

GitHub复制人看不见技能

1. 需要完全重新启动：完全退出VS代码（Cmd+Q）并重新打开
2. 检查配置路径：确保 .vscode/mcp.json 位于工作区根目录中
3. 验证服务器：运行 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之前。

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

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

______________________________________________________________________

文档和演示

GitHub页面

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

1. 创建文档 （推荐：使用 /docs 文件夹）：

- 创建 docs/ 存储库根目录中的目录 - 添加一个 index.html 文件或使用静态站点生成器，如VitePress或Docusaurus - 这使得文档与源代码分开

1. 启用GitHub页面:

- 转到您的存储库 设置 → 页面 - 选择 源：从分支部署 - 选择 分支: main 和文件夹 /docs （推荐）或 / 如果部署整个仓库 - 保存并等待部署

这有助于：

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

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

______________________________________________________________________

许可证

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

______________________________________________________________________

相关项目

• VoltAgent -AI代理框架
• 出色的代理技能 -源技能集合
• MCP服务器 -官方MCP服务器实施

______________________________________________________________________

Made with ❤️ for the AI agent community

⭐ Star the Awesome Agent Skills repository