出色的代理技能MCP服务器
> 模型上下文协议(MCP)服务器,提供对100多种精心策划的AI代理技能的访问 VoltAgent出色的代理技能 收藏。
将您的人工智能助手转变为具有Anthropic、Vercel、Trail of Bits、Hugging Face、Stripe、Expo等众多领先组织技能的专业专家。
🚀 快速开始```bash
npx awesome-agent-skills-mcp
就是这样!添加到您的MCP客户端配置中,开始使用100多种AI技能。
______________________________________________________________________
## 目录
- 特性
- 快速开始
- 安装
- 配置
- VS代码/GitHub副本
- 克劳德桌面版
- 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(推荐)```bash
npx awesome-agent-skills-mcp
全球安装```bash
npm install -g awesome-agent-skills-mcp
awesome-agent-skills-mcp
______________________________________________________________________
## 安装
### 先决条件
- **Node.js** >= 20.0.0
- **npm** 或 **纱线**
### 来自npm```bash
npm install awesome-agent-skills-mcp
来源```bash
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` 在您的项目中:```json
{
"servers": {
"awesome-agent-skills": {
"command": "npx",
"args": ["awesome-agent-skills-mcp"]
}
}
}
或者使用本地安装:```json
{
"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上):```json
{
"mcpServers": {
"awesome-agent-skills": {
"command": "npx",
"args": ["awesome-agent-skills-mcp"]
}
}
}
OpenCode
添加到 ~/.config/opencode/opencode.json:```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`
使用可选筛选列出所有可用技能。```typescript
// List all skills
{ }
// Filter by source
{ "source": "repository" }
// Filter by tag
{ "tag": "security" }
get_skill
获取特定技能的详细信息。```typescript
{ "skill_id": "react-best-practices" }
### `invoke_skill`
使用可选参数调用技能。```typescript
{
"skill_id": "docx",
"parameters": {
"document_type": "report"
}
}
refresh_skills
从存储库手动触发技能刷新。```typescript
{ }
______________________________________________________________________
## 用法示例
### 在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
______________________________________________________________________
## 发展
### 设置```bash
git clone https://github.com/shadowrootdev/awesome-agent-skills-mcp.git
cd awesome-agent-skills-mcp
npm install
构建```bash
npm run build
### 运行测试```bash
# Run all tests
npm test
# Run tests in watch mode
npm run test:watch
# Run integration tests only
npm run test:integration
棉绒和格式```bash
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参考
技能对象```typescript
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;
}
### 参数架构```typescript
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手动测试
连接错误```bash
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许可证获得许可-请参阅 许可证 文件以获取详细信息。
相关项目
- VoltAgent -AI代理框架
- 出色的代理技能 -源技能集合
- MCP服务器 -官方MCP服务器实施
Made with ❤️ for the AI agent community
⭐ Star the Awesome Agent Skills repository
