Awesome Agent Skills MCP

🚀 Awesome Agent Skills MCP Server

VoltAgent Awesome Agent Skills コレクションから選りすぐった100以上のAIエージェントスキルにアクセスできる、Model Context Protocol (MCP) サーバーです。

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準拠 - 最新のModel Context Protocol仕様と完全に互換性があります。
• 複数クライアント対応 - 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

🔧 設定

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

環境変数

💻 使用例

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

🔧 技術詳細

セットアップ

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       # SkillRegistryクラス
│   │   └── 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/                   # ランタイムキャッシュ（gitignored）

📚 詳細ドキュメント

スキルオブジェクト

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 ファイルを参照してください。