MCP-skill-library-dynamic 🚀

Un servidor MCP (Model Context Protocol) de nivel empresarial que sirve archivos de habilidades y reglas desde un directorio local a agentes de IA bajo demanda. Permite a los agentes de IA listar y obtener dinámicamente instrucciones de habilidades específicas formateadas en Markdown sin sufrir de inflación de contexto.

✨ Características (v1.2.0)

• TypeScript Native: 100% seguro de tipos, compilado a módulos ES optimizados.

• Curated 200+ Core Skills Base: Conjunto de habilidades de alta calidad, deduplicado y estándar de la comunidad, preindexado en skills-base.json.

• Deterministic Offline-First Downloader: Descargas por lotes rápidas y confiables directamente desde la lista base seleccionada usando npx skills add con reintentos de retroceso exponencial.

• Smart Search & Filter: list_skills admite un parámetro opcional query (por ejemplo, list_skills({ query: "react" })) para filtrar habilidades directamente y ahorrar tokens.

• Recursive Multi-File Rule Aggregation: fetch_skill_rule escanea y combina automáticamente todos los archivos Markdown anidados (por ejemplo, rules/*.md, references/*.md) sin omitir documentación más profunda.

• Zero-Config Auto-Path Resolution: Resuelve inteligentemente .agents/skills en relación con la ubicación del servidor compilado, eliminando problemas de configuración manual de SKILLS_DIR.

• Ghost Skill Elimination: Ignora automáticamente directorios vacíos y solo sirve carpetas con archivos de reglas .md verificados.

• Memory-Safe Caching: Utiliza una caché TTL para el listado de directorios y E/S asíncrona para la lectura de archivos, garantizando 0% de probabilidad de fallos por falta de memoria (OOM), incluso con más de 100,000 habilidades.

• Path Traversal Protection: Resolución de rutas con grado criptográfico para aislar estrictamente a la IA al directorio .agents/skills/.

• Graceful Shutdown: Maneja adecuadamente SIGINT/SIGTERM y excepciones no capturadas para asegurar cierres limpios de los sockets MCP.

• Token Diet Architecture (Cost Saving):

  • list_skills solo devuelve nombres de carpetas sin procesar (slugs), minimizando el contexto inyectado a solo ~1,500 tokens incluso con más de 1,000 habilidades.

  • fetch_skill_rule obtiene contenido estrictamente bajo demanda, una habilidad a la vez, previniendo alucinaciones de IA y facturas masivas de API.

Related MCP server: SkillMCP

📦 Instalación y compilación

1. Clona o descarga el repositorio:

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

2. Instala las dependencias:

npm install

3. Compila el código fuente de TypeScript:

npm run build

🧠 Descarga y gestión de habilidades

Las habilidades se cargan en .agents/skills/ ubicado en la raíz del proyecto (o configurado mediante SKILLS_DIR).

Habilidades base seleccionadas (skills-base.json)

El descargador utiliza skills-base.json como la única fuente de verdad que contiene más de 200 habilidades seleccionadas y deduplicadas de repositorios oficiales y de primer nivel (anthropics/skills, obra/superpowers, affaan-m/ecc, browser-use, etc.).

Comandos CLI

Ejemplos

# 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

📁 Estructura de directorios

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

🚀 Ejecutando el servidor

Inicia el servidor usando:

npm start

⚙️ Configuración de MCP

Para conectar este servidor con un cliente MCP (como Antigravity, Cursor, Roo Code o Cline), agrega la siguiente configuración al archivo de configuración de tu cliente:

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

Importante: Reemplaza C:/path/to/skill-library-mcp con la ruta real de tu repositorio, apuntando a dist/index.js.

🤖 Prompt del sistema (Protocolo de base de conocimiento)

Agrega el siguiente prompt a las reglas de tu agente de IA (.clinerules, .cursorrules o Instrucciones personalizadas) para que el agente use automáticamente la Biblioteca de Habilidades:

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

📜 Licencia

MIT