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代理社區用心打造
⭐ 給超棒的代理技能倉庫點個星