Fabric MCP 서버 완전 가이드 — Claude Code에 240개 AI 패턴과 개발자 지식베이스 연결하기

유튜브 영상을 핵심 인사이트로 추출하고, 디버깅 결과를 자동 저장하고, 보안 위협 모델을 즉시 뽑아냅니다. 터미널 한 줄로요.

[핵심 요약]
→ Fabric (Daniel Miessler): 240개+ AI 패턴 라이브러리 — 오픈소스
→ Fabric MCP 서버: Claude Code에서 Fabric 패턴 직접 실행
→ Fabric.so: AI 지식베이스 앱, MCP로 Claude Code와 연동
→ 설치: Node.js + npm 또는 .mcpb 번들로 5분 설치
→ 주요 패턴: extract_wisdom, create_summary, analyze_threat, create_flashcards 등
→ 활용: 유튜브 분석, 기술 문서 요약, 디버깅 기록 자동화, 보안 분석
→ 비용 추가: MCP 호출당 200~400 토큰 추가 (월 $10~15 수준)

 

---

Fabric이란?

Fabric은 Daniel Miessler가 만든 오픈소스 AI 패턴 프레임워크입니다. "사람의 문제를 AI로 해결하기 위한 패턴 모음"이라고 정의합니다.

기존 AI 사용 방식:
→ 매번 긴 프롬프트 작성
→ 같은 작업 반복할 때마다 동일한 지시
→ 팀원마다 다른 프롬프트 품질

Fabric 방식:
→ 검증된 패턴 240개+를 명령어 하나로 실행
→ extract_wisdom → 영상/글의 핵심 인사이트 추출
→ analyze_threat_model → 코드베이스 보안 위협 분석
→ create_summary → 기술 문서 요약
→ create_flashcards → 학습 카드 자동 생성

[패턴 카테고리]
→ 분석: analyze_code, analyze_threat_model, analyze_paper
→ 추출: extract_wisdom, extract_insights, extract_patterns
→ 생성: create_summary, create_flashcards, create_quiz
→ 코딩: improve_code, create_coding_project, review_design
→ 보안: create_threat_scenarios, analyze_malware, rate_content
→ 글쓰기: write_essay, improve_prompt, create_report

---

실전 1 — Fabric CLI 설치

MCP 서버 연결 전에 Fabric CLI를 먼저 설치합니다.

# pipx로 설치 (권장)
pipx install fabric-ai

# 또는 pip
pip install fabric-ai

# Fabric 초기 설정 (API 키, 패턴 다운로드)
fabric --setup
# → LLM API 키 입력 (OpenAI, Claude, Gemini 중 선택)
# → 240개+ 패턴 자동 다운로드

# 패턴 목록 확인
fabric --list-patterns

# 기본 사용 테스트
echo "이 코드에서 문제점을 찾아줘: for i in range(1000000): print(i)" | fabric -p analyze_code

# YouTube 영상 분석
fabric -y "https://youtube.com/watch?v=xxx" -p extract_wisdom

[주요 패턴 실전 예시]
→ 기술 영상 분석: fabric -y [URL] -p extract_wisdom
→ 코드 리뷰: cat code.py | fabric -p analyze_code
→ 문서 요약: cat README.md | fabric -p create_summary
→ 보안 분석: cat app.py | fabric -p analyze_threat_model
→ 학습 카드: cat article.md | fabric -p create_flashcards

---

실전 2 — Fabric MCP 서버 설치 및 Claude Code 연동

# Node.js 18+ 필요
node --version

# 방법 1: .mcpb 번들 (가장 간단)
# github.com/mpzarde/fabric-mcp 에서 .mcpb 다운로드
# Claude Desktop: 자동 설정
# Claude Code: 수동 설정 필요

# 방법 2: 소스에서 빌드
git clone https://github.com/mpzarde/fabric-mcp
cd fabric-mcp
npm install
npm run build

# 빌드 확인
node dist/index.js
# → "MCP server running on stdio" 출력되면 성공

Claude Code 설정 (~/.claude.json):

{
  "mcpServers": {
    "fabric": {
      "command": "node",
      "args": ["/absolute/path/to/fabric-mcp/dist/index.js"]
    }
  }
}

# 설정 확인
claude mcp list
# → fabric 서버가 목록에 보여야 함

# 헬스체크
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"health_check","arguments":{}}}' | node dist/index.js

[설치 확인 포인트]
→ Fabric CLI가 먼저 설치되어 있어야 함
→ /absolute/path: 상대경로 쓰면 안 됨, pwd로 절대경로 확인
→ Claude Code 재시작 후 /mcp 명령으로 연결 확인
→ 헬스체크에서 "fabric: ok" 나오면 정상

---

실전 3 — Claude Code에서 Fabric 패턴 실행

설치 완료 후 Claude Code 터미널에서 바로 사용합니다.

# Claude Code 세션 시작
claude

# Fabric 패턴 사용 예시 (Claude Code 내에서)
> 이 유튜브 영상 핵심 인사이트 뽑아줘: https://youtube.com/watch?v=xxx
# → Claude가 get_youtube_transcript → fabric_extract_wisdom 순서로 실행

> 방금 디버깅한 내용 Fabric에 정리해서 저장해줘
# → Claude가 fabric 패턴으로 요약 → 저장

> 이 코드 보안 위협 모델 분석해줘
# → Claude가 analyze_threat_model 패턴 실행

19개 사전 설정 툴 목록:

# Fabric MCP 서버가 제공하는 주요 툴
fabric_tools = {
    # 유튜브 관련
    "get_youtube_transcript": "유튜브 URL → 자막 텍스트 추출",
    "fabric_youtube_wisdom": "유튜브 URL → extract_wisdom 패턴 한 번에",

    # 패턴 실행
    "run_fabric_pattern": "임의의 Fabric 패턴 실행 (범용)",
    "fabric_extract_wisdom": "텍스트에서 핵심 인사이트 추출",
    "fabric_create_summary": "텍스트 요약 생성",
    "fabric_analyze_code": "코드 분석 및 개선점 제안",
    "fabric_analyze_threat_model": "보안 위협 모델 분석",
    "fabric_create_flashcards": "학습 플래시카드 생성",
    "fabric_improve_prompt": "프롬프트 품질 개선",

    # 파일/URL 처리
    "fabric_analyze_file": "파일 내용 + 패턴 적용",
    "fabric_analyze_url": "URL 내용 크롤링 + 패턴 적용",

    # 패턴 관리
    "list_fabric_patterns": "설치된 패턴 목록 조회",
    "health_check": "Fabric 설치 상태 확인"
}

---

실전 4 — 개발자 지식베이스 자동 구축 워크플로우

코딩 세션에서 발생하는 지식을 자동으로 캡처하고 저장합니다.

# CLAUDE.md에 추가할 내용

## 지식 캡처 규칙

### 자동 저장 트리거
다음 상황에서 Fabric으로 내용을 정리하고 저장해:

1. **디버깅 완료 시**
   - 문제 원인 + 해결 방법을 `extract_wisdom`으로 정리
   - 파일: `.knowledge/debugging/YYYY-MM-DD-[이슈명].md`

2. **아키텍처 결정 시**
   - 결정 배경 + 트레이드오프를 `create_summary`로 정리
   - 파일: `.knowledge/decisions/ADR-[번호]-[주제].md`

3. **외부 문서 참고 시**
   - URL 내용을 `fabric_analyze_url`로 핵심만 추출
   - 파일: `.knowledge/references/[날짜]-[출처].md`

4. **에러 해결 시**
   - 에러 메시지 + 원인 + 해결을 저장
   - 파일: `.knowledge/errors/[에러명].md`

### 검색 규칙
- 새 기능 시작 전: .knowledge/ 디렉토리 관련 내용 먼저 확인
- 비슷한 버그: 이전 디버깅 기록 먼저 참조

# 지식베이스 디렉토리 구조
"""
.knowledge/
├── debugging/
│   ├── 2026-04-22-jwt-expiry-bug.md
│   ├── 2026-04-20-race-condition-payment.md
│   └── ...
├── decisions/
│   ├── ADR-001-database-choice.md
│   ├── ADR-002-auth-strategy.md
│   └── ...
├── references/
│   ├── 2026-04-22-vllm-optimization.md
│   └── ...
└── errors/
    ├── cuda-oom-error.md
    ├── docker-network-issue.md
    └── ...
"""

# 6주 후 예상 결과 (실제 사례 기반)
stats = {
    "자동 생성 항목": "147개",
    "하루 평균 검색": "3~4회",
    "검색 히트율": "70%",
    "절약 시간": "주 2~3시간 (재조사 방지)"
}

---

실전 5 — Fabric.so 연동 (선택)

Fabric.so는 별도 AI 지식베이스 앱으로, MCP 서버를 통해 Claude Code와 연동할 수 있습니다.

// ~/.claude.json — Fabric.so MCP 추가
{
  "mcpServers": {
    "fabric-patterns": {
      "command": "node",
      "args": ["/path/to/fabric-mcp/dist/index.js"]
    },
    "fabric-so": {
      "command": "npx",
      "args": ["@fabric-so/mcp-server"],
      "env": {
        "FABRIC_API_KEY": "your-fabric-so-api-key"
      }
    }
  }
}

[Fabric.so vs 로컬 .knowledge/ 비교]

로컬 .knowledge/ 디렉토리:
→ 설정 복잡도: 낮음 (그냥 파일)
→ 검색: 키워드 기반 (grep)
→ 비용: 0원
→ 팀 공유: Git으로 가능
→ 추천 대상: 개인 개발자, 소규모 팀

Fabric.so:
→ 설정 복잡도: 중간 (API 키 필요)
→ 검색: 시맨틱 검색 (의미 기반)
→ 비용: 유료 구독
→ 팀 공유: 실시간 협업
→ 추천 대상: 팀 단위 지식 관리 필요할 때

---

실전 6 — 유튜브 기술 영상 자동 분석 파이프라인

개발 관련 유튜브 영상을 보면서 핵심만 자동 추출합니다.

# Claude Code에서 유튜브 영상 분석
# (Fabric MCP 서버 연결된 상태)

# 사용 예시 1: 영상 핵심 인사이트 추출
> 이 영상 extract_wisdom 패턴으로 분석해줘
> https://youtube.com/watch?v=dQw4w9WgXcQ

# Claude가 내부적으로 실행하는 것:
# 1. get_youtube_transcript(url) → 자막 추출
# 2. fabric_extract_wisdom(transcript) → 패턴 적용
# 3. 결과: 핵심 인사이트, 아이디어, 인용구, 습관 등 구조화된 요약

# 사용 예시 2: 영상 → 플래시카드 변환
> 이 강의 영상 플래시카드로 만들어줘
> https://youtube.com/watch?v=lecture123

# 사용 예시 3: 기술 문서 → 요약
> 이 문서 핵심만 뽑아줘: https://docs.anthropic.com/claude-code

# 사용 예시 4: 코드베이스 보안 분석
> 이 파일들 보안 위협 모델 분석해줘
> (파일들을 컨텍스트에 추가 후)

[extract_wisdom 출력 구조]
→ ONE-SENTENCE-SUMMARY: 한 줄 핵심
→ MAIN-POINTS: 핵심 포인트 10개
→ TAKEAWAYS: 실용적 교훈 5개
→ QUOTES: 인상적인 인용구
→ HABITS: 언급된 습관/루틴
→ FACTS: 구체적 수치/사실
→ REFERENCES: 언급된 책/도구/링크
→ RECOMMENDATIONS: 행동 권고사항

---

마무리

✅ Fabric MCP 써야 할 때
→ 기술 영상/문서를 자주 참고하는 개발자
→ 디버깅 과정을 나중에 재활용하고 싶을 때
→ 보안 코드리뷰 자동화가 필요할 때
→ 학습 내용을 플래시카드로 자동 변환
→ 터미널에서 나가지 않고 모든 작업 처리 원할 때
→ 팀 공유 가능한 패턴화된 AI 워크플로우

❌ 안 써도 될 때
→ 단순 Q&A 위주로만 Claude Code 사용할 때
→ 패턴 240개가 필요 없는 단순 작업
→ Node.js 설치 귀찮을 때 (대안: CLI만 써도 됨)
→ 지식 관리에 투자할 여력이 없을 때

---

제목 추천

1. 서버 완전 가이드 — Claude Code에 240개 AI 패턴과 개발자 지식베이스 연결하기
2. 코딩 세션이 끝나면 지식베이스가 쌓인다 — Fabric MCP + Claude Code 완전 셋업
3. Claude Code에 Fabric 붙이기 — 유튜브 분석, 보안 리뷰, 디버깅 기록 자동화 완전 가이드

---

관련 글:

 

Claude Code용 주요 MCP 서버 15개 — 실전 설치 가이드

 

매번 설명 반복하다 지쳤다면 — Claude Code 4레이어 컨텍스트 시스템

 

 

MCP 서버 직접 만들기 — 내 서비스를 Claude에 연동하는 법