MCP-skill-library-dynamic 🚀

로컬 디렉토리의 스킬 및 규칙 파일을 AI 에이전트에게 온디맨드로 제공하는 엔터프라이즈급 MCP(Model Context Protocol) 서버입니다. AI 에이전트가 Context Bloat(컨텍스트 비대화) 없이 Markdown으로 작성된 특정 스킬 지침을 동적으로 나열하고 가져올 수 있게 해줍니다.

✨ 주요 기능 (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개 이상의 스킬이 있어도 OOM(메모리 부족) 크래시 가능성을 0%로 보장합니다.

• 경로 탐색 보호: 암호화급 경로 해석으로 AI를 .agents/skills/ 디렉토리에 엄격하게 샌드박싱합니다.

• 우아한 종료: SIGINT/SIGTERM 및 처리되지 않은 예외를 적절히 처리하여 MCP 소켓을 깨끗하게 닫습니다.

• 토큰 다이어트 아키텍처(비용 절감):

  • list_skills는 원시 폴더 이름(슬러그)만 반환하여 1,000개 이상의 스킬이 있어도 주입되는 컨텍스트를 약 1,500 토큰으로 최소화합니다.

  • 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

🧠 스킬 다운로드 및 관리

스킬은 프로젝트 루트(또는 SKILLS_DIR로 구성된 위치)에 있는 .agents/skills/에 로드됩니다.

큐레이션된 기본 스킬(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 에이전트가 스킬 라이브러리를 자동으로 사용하도록 에이전트 규칙(.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