🕷️ RECLUSE — autonomous web-contract verification (MCP + shared corpus)

RECLUSE (은둔독거미) — 이음매에 숨은 버그를 문다. 거미줄로 시스템 이음매(생산자→저장소→소비자 계약)를 흔들어 버그를 잡고, 등급 매칭 거미(King/Mid/Baby)가 자율 수정하고, 재직조로 회귀를 막는 폐루프. 쓰는 사람이 늘수록 공유 corpus가 두꺼워져 모두의 거미가 강해진다(집단 두뇌).

구성

spider-mcp/
├── src/index.js            # MCP 서버(stdio) — 방법론을 tool/resource로 노출
├── corpus-backend/         # 공유 corpus(집단 거미 두뇌)
│   ├── schema.sql          #   중앙 패턴 DB + 익명 기여 집계 + dedup RPC (Postgres/Supabase)
│   ├── scrub.js            #   ⭐ 스크럽 파이프라인 — 코드·시크릿·식별정보 제거, 일반화 기법만
│   ├── api.js              #   기여/조회 HTTP API
│   └── package.json
└── (스킬 공유) ~/.claude/skills/spiderweb-qc/references/{checklist,contract-queries,learned-patterns,live-web-blackbox}

Related MCP server: Smart Contract Security Analyzer

아키텍처 — 집단 거미 두뇌(네트워크 효과)

 유저A 거미 ─┐  잡은 버그 패턴 기여(opt-in)        ┌─▶ 유저A: 라운드 시작 시 전체 패턴 pull
 유저B 거미 ─┼─▶ [스크럽] ─▶ 중앙 패턴 DB(dedup) ─┼─▶ 유저B: 알려진 함정 0라운드에 점검
 유저C 거미 ─┘   코드/시크릿 거부, 기법만          └─▶ 유저C

• 유저↑ → 패턴↑ → corpus↑ → 모두의 거미가 더 잡음 → 유저↑ (백신 시그니처 DB식 데이터 해자).

• 신뢰 핵심 = 스크럽: file:line·코드 리터럴·시크릿(키/JWT/고엔트로피)·이메일·URL·IP를 자리표시자로 치환하고, 잔존 의심 시 저장 거부(scrub.js). 일반화된 기법만 공유.

• opt-in·익명: 기여자/프로젝트는 불가역 해시(서버 솔트)로만 집계 — 신원·원문 저장 안 함. 엔터프라이즈는 사설 corpus(공유 끔).

배포

1) 공유 corpus 백엔드

cd corpus-backend && npm install
# 스키마 적용: Supabase 프로젝트에 schema.sql 실행(SQL editor 또는 migration)
SUPABASE_URL=... SUPABASE_SERVICE_ROLE_KEY=... SPIDER_SALT=<랜덤> \
  SPIDER_API_KEYS=key1,key2  npm start          # :8787
# 스크럽 동작 확인(시크릿/코드가 거부되는지)
npm run test:scrub

API:

• POST /v1/patterns {klass,name,signal,fix,tags?,severity?,tier?} → 스크럽·dedup·신뢰도 누적

• GET /v1/patterns?tags=postgres,payment&class=단위&limit=50 → 집단 corpus(verified·hit_count 순)

• GET /healthz

2) MCP 서버(클라이언트 연결)

cd spider-mcp && npm install

Claude Code / Desktop MCP 설정:

{ "mcpServers": { "spider": {
  "command": "node", "args": ["/Users/vinsenzo/spider-mcp/src/index.js"],
  "env": {
    "SPIDER_CORPUS_API": "https://corpus.example.com",
    "SPIDER_CORPUS_TOKEN": "<익명 기여자 토큰>"
  } } } }

MCP tools: spider_plan · spider_classify_tier · spider_checklist · spider_record_pattern(로컬+공유 기여) · spider_pull_corpus(집단 pull). MCP resources: spider://checklist · spider://queries · spider://corpus · spider://blackbox.

제품화 사다리

1. MCP/스킬(무료·오픈) — 개발자 침투(현재 단계).

2. CI 게이트(Pro) — spider weave 🔴면 머지 차단(GitHub Action).

3. 공유 corpus + 블랙박스 모니터링(SaaS 매출) — 집단 두뇌 + 라이브 신경망 호스팅(해자·과금).

4. 엔터프라이즈 — 사설 corpus·온프렘·SLA.

원칙

사실 왜곡 금지(실제 증거만) · 스크럽 우선(새는 것보다 막기) · opt-in·익명 · 탐지=read-only, 수정=격리 거미.