MCP-skill-library-dynamic 🚀

AIエージェントにオンデマンドでスキルファイルとルールファイルをローカルディレクトリから提供する、エンタープライズグレードのMCP（Model Context Protocol）サーバーです。AIエージェントが特定のスキル指示をMarkdown形式で動的に一覧表示・取得できるようにし、コンテキストの肥大化（Context Bloat）を防ぎます。

✨ 機能（v1.2.0）

• TypeScriptネイティブ: 100%型安全で、最適化されたES Modulesにコンパイルされます。

• 精選された200以上のコアスキルベース: skills-base.jsonに事前インデックス化された、高品質・重複排除・コミュニティ標準のスキルセットです。

• 決定的なオフライン優先ダウンローダー: npx skills addを使用して、指数バックオフリトライ付きで精選ベースリストから直接、高速かつ信頼性の高いバッチダウンロードを実行します。

• スマート検索＆フィルタ: list_skillsはオプションのqueryパラメータ（例: list_skills({ query: "react" })）をサポートし、スキルを直接フィルタリングしてトークンを節約します。

• 再帰的な複数ファイルルール集約: fetch_skill_ruleは、より深いドキュメントをスキップすることなく、ネストされたすべてのMarkdownファイル（例: rules/*.md、references/*.md）を自動的にスキャンして結合します。

• ゼロ設定の自動パス解決: コンパイル済みサーバーの場所を基準に.agents/skillsをインテリジェントに解決し、手動でのSKILLS_DIR設定の問題を排除します。

• ゴーストスキル排除: 空のディレクトリを自動的に無視し、検証済みの.mdルールファイルがあるフォルダのみを提供します。

• メモリ安全なキャッシング: ディレクトリ一覧にはTTLキャッシュを、ファイル読み取りには非同期I/Oを利用し、100,000以上のスキルがあってもOut-Of-Memory（OOM）クラッシュの可能性を0%に保証します。

• パストラバーサル保護: 暗号学的グレードのパス解決により、AIを.agents/skills/ディレクトリ内に厳格にサンドボックス化します。

• グレースフルシャットダウン: SIGINT/SIGTERMおよび未捕捉例外を適切に処理し、MCPソケットのクリーンなクローズを保証します。

• トークンダイエットアーキテクチャ（コスト削減）:

  • list_skillsは生のフォルダ名（スラッグ）のみを返し、1,000以上のスキルがあっても注入されるコンテキストを約1,500トークンに最小化します。

  • fetch_skill_ruleはオンデマンドで一度に1つのスキルのみを厳密に取得し、AIの幻覚と莫大なAPIコストを防ぎます。

Related MCP server: SkillMCP

📦 インストール＆ビルド

1. リポジトリをクローンまたはダウンロードします:

git clone https://github.com/Guslaier/MCP-skill-library-dynamic.git
cd skill-library-mcp

2. 依存関係をインストールします:

npm install

3. TypeScriptソースコードをコンパイルします:

npm run build

🧠 スキルのダウンロードと管理

スキルはプロジェクトのルートにある.agents/skills/に読み込まれます（またはSKILLS_DIRで設定可能）。

精選ベーススキル（skills-base.json）

ダウンローダーはskills-base.jsonを、公式およびトップティアのリポジトリ（anthropics/skills、obra/superpowers、affaan-m/ecc、browser-useなど）から収集した200以上の精選・重複排除スキルを含む単一の情報源として使用します。

CLIコマンド

例

# Download all 200+ curated base skills
npm run download

# Download only specific skills matching 'caveman'
npm run download -- caveman

# Download all React / Frontend related skills
npm run download -- react

📁 ディレクトリ構造

skill-library-mcp/
├── package.json
├── tsconfig.json
├── skills-base.json        # Curated index of 200+ skills (name, repo url, description)
├── src/
│   ├── index.ts            # MCP Server entry point
│   └── download-skills.ts  # Batch downloader from skills-base.json
├── dist/
│   ├── index.js
│   └── download-skills.js
└── .agents/
    └── skills/             # Local skill files served to AI agents
        ├── code-review/
        │   └── SKILL.md
        ├── test-driven-development/
        │   └── SKILL.md
        └── ...

🚀 サーバーの実行

以下のコマンドでサーバーを起動します:

npm start

⚙️ MCP設定

このサーバーをMCPクライアント（Antigravity、Cursor、Roo Code、Clineなど）に接続するには、クライアントの設定ファイルに以下の設定を追加します:

{
  "mcpServers": {
    "skill-library": {
      "command": "node",
      "args": [
        "C:/path/to/skill-library-mcp/dist/index.js"
      ],
      "env": {
        "SKILLS_DIR": "C:/path/to/skill-library-mcp/.agents/skills"
      }
    }
  }
}

重要: C:/path/to/skill-library-mcpを実際のリポジトリパスに置き換え、dist/index.jsを指すようにしてください。

🤖 システムプロンプト（ナレッジベースプロトコル）

AIエージェントがスキルライブラリを自動的に使用するように、以下のプロンプトをAIエージェントのルール（.clinerules、.cursorrules、またはカスタム指示）に追加します:

# UNIVERSAL KNOWLEDGE BASE PROTOCOL
You are equipped with the Enterprise "Skill Library MCP". Before starting any architectural planning, refactoring, or feature implementation, you MUST:
1. Use `list_skills` (or `list_skills({ query: "keyword" })`) to check for relevant domain rules or coding standards.
2. If found, use `fetch_skill_rule({ skill_name: "..." })` to read the full context and nested rule guidelines.
3. Explicitly acknowledge the rules and apply them strictly to your code generation.

📜 ライセンス

MIT