MCP-skill-library-dynamic 🚀

Ein Enterprise-tauglicher MCP-Server (Model Context Protocol), der Skill- und Regeldateien aus einem lokalen Verzeichnis auf Abruf an KI-Agenten bereitstellt. Er ermöglicht es KI-Agenten, spezifische, in Markdown formatierte Skill-Anweisungen dynamisch aufzulisten und abzurufen, ohne unter Context Bloat zu leiden.

✨ Funktionen (v1.2.0)

• TypeScript-nativ: 100 % typsicher, kompiliert zu optimierten ES-Modulen.

• Kuratierte Basis mit 200+ Kern-Skills: Hochwertiger, deduplizierter und community-standardisierter Skill-Satz, vorindexiert in skills-base.json.

• Deterministischer Offline-First-Downloader: Schnelle, zuverlässige Batch-Downloads direkt aus der kuratierten Basisliste mit npx skills add und exponentiellen Backoff-Wiederholungen.

• Intelligente Suche & Filter: list_skills unterstützt den optionalen Parameter query (z. B. list_skills({ query: "react" })), um Skills direkt zu filtern und Tokens zu sparen.

• Rekursive Multi-Datei-Regelaggregation: fetch_skill_rule scannt und kombiniert automatisch alle verschachtelten Markdown-Dateien (z. B. rules/*.md, references/*.md), ohne tiefere Dokumentation zu überspringen.

• Automatische Pfadauflösung ohne Konfiguration: Löst .agents/skills intelligent relativ zum kompilierten Server-Speicherort auf und eliminiert manuelle SKILLS_DIR-Einrichtungsprobleme.

• Beseitigung von Geister-Skills: Ignoriert automatisch leere Verzeichnisse und stellt nur Ordner mit verifizierten .md-Regeldateien bereit.

• Speichersicheres Caching: Verwendet einen TTL-Cache für die Verzeichnisauflistung und asynchrones I/O für das Lesen von Dateien, um eine 0%ige Wahrscheinlichkeit von Out-of-Memory-Abstürzen (OOM) zu garantieren, selbst bei 100.000+ Skills.

• Schutz vor Pfad-Traversal: Kryptografisch abgesicherte Pfadauflösung, um die KI strikt auf das Verzeichnis .agents/skills/ zu beschränken.

• Sanftes Herunterfahren: Behandelt SIGINT/SIGTERM und unbehandelte Ausnahmen ordnungsgemäß, um saubere MCP-Socket-Schließungen zu gewährleisten.

• Token-Diät-Architektur (Kostenersparnis):

  • list_skills gibt nur rohe Ordnernamen (Slugs) zurück und minimiert den injizierten Kontext auf nur ~1.500 Tokens, selbst bei 1.000+ Skills.

  • fetch_skill_rule ruft Inhalte strikt on-demand ab, jeweils einen Skill nach dem anderen, und verhindert so KI-Halluzinationen und massive API-Rechnungen.

Related MCP server: SkillMCP

📦 Installation & Build

1. Klonen oder laden Sie das Repository herunter:

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

2. Abhängigkeiten installieren:

npm install

3. TypeScript-Quellcode kompilieren:

npm run build

🧠 Herunterladen & Verwalten von Skills

Skills werden in .agents/skills/ im Projektstamm geladen (oder über SKILLS_DIR konfiguriert).

Kuratierte Basis-Skills (skills-base.json)

Der Downloader verwendet skills-base.json als einzige Quelle der Wahrheit, die 200+ kuratierte und deduplizierte Skills aus offiziellen und erstklassigen Repositories enthält (anthropics/skills, obra/superpowers, affaan-m/ecc, browser-use usw.).

CLI-Befehle

Beispiele

# 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

📁 Verzeichnisstruktur

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
        └── ...

🚀 Server starten

Starten Sie den Server mit:

npm start

⚙️ MCP-Konfiguration

Um diesen Server mit einem MCP-Client (wie Antigravity, Cursor, Roo Code oder Cline) zu verbinden, fügen Sie die folgende Konfiguration zur Einstellungsdatei Ihres Clients hinzu:

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

Wichtig: Ersetzen Sie C:/path/to/skill-library-mcp durch Ihren tatsächlichen Repository-Pfad, der auf dist/index.js zeigt.

🤖 System-Prompt (Knowledge-Base-Protokoll)

Fügen Sie den folgenden Prompt zu Ihren KI-Agenten-Regeln hinzu (.clinerules, .cursorrules oder Custom Instructions), damit der Agent automatisch die Skill-Bibliothek verwendet:

# 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.

📜 Lizenz

MIT