MCP-skill-library-dynamic 🚀

Сервер MCP (Model Context Protocol) корпоративного уровня, который предоставляет файлы навыков и правил из локального каталога AI-агентам по запросу. Он позволяет AI-агентам динамически перечислять и получать конкретные инструкции по навыкам, отформатированные в Markdown, без раздувания контекста.

✨ Возможности (v1.2.0)

• Нативный TypeScript: 100% типобезопасный, компилируется в оптимизированные ES-модули.

• Курируемая база из 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-кэш для списка каталогов и асинхронный ввод-вывод для чтения файлов, что гарантирует 0% вероятность сбоев из-за нехватки памяти (OOM), даже при наличии 100 000+ навыков.

• Защита от обхода пути: криптографическое разрешение путей для строгой изоляции AI в каталоге .agents/skills/.

• Корректное завершение работы: правильно обрабатывает SIGINT/SIGTERM и неперехваченные исключения для обеспечения чистого закрытия сокетов MCP.

• Архитектура экономии токенов (снижение затрат):

  • list_skills возвращает только имена папок (слаги), сводя вводимый контекст к ~1 500 токенам даже при наличии 1 000+ навыков.

  • fetch_skill_rule строго получает контент по запросу, по одному навыку за раз, предотвращая галлюцинации 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 как единственный источник истины, содержащий 200+ курируемых и дедуплицированных навыков из официальных и ведущих репозиториев (anthropics/skills, obra/superpowers, affaan-m/ecc, browser-use и т.д.).

Команды 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-агента (.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