@clawket/mcp

MCP (Model Context Protocol) server for Clawket.

LLM이 tool_use로 Clawket의 RAG 저장소를 pull 방식 탐색하게 하는 stdio 서버. SessionStart hook의 고정 주입(Push)이 커버하지 못하는 탐색적·조건부 조회를 담당.

상태

Status: Pre-alpha / Scaffolding (CK-299) Spec: Clawket artifact ART-01KPCQ4ZPF0HHJ029WERJAHWD3 Unit: P7 (UNIT-01KPCPQKDW2NQ91BJC6HFN8XQB)

아직 도구가 구현되지 않았습니다. 빌드 후 stdio 핸드셰이크만 응답합니다.

설치

Clawket CLI를 설치하면 자동으로 동반 설치됩니다 (CK-302 이후).

pnpm install @clawket/mcp   # 단독 사용 시

실행

Claude Code 플러그인으로 자동 기동 (권장, CK-303 이후)

Seungwoo321-clawket 플러그인을 설치하면 .mcp.json이 자동 등록됩니다.

수동 실행

clawket mcp        # CK-302 이후: CLI 서브커맨드
node dist/index.js # 빌드 후 직접 실행

노출 도구 (예정)

도구	용도
clawket_search_artifacts	설계 문서·결정사항 시맨틱 검색
clawket_search_tasks	Task 검색
clawket_find_similar_tasks	유사 과거 Task + 결정/이슈 추출
clawket_get_task_context	특정 Task 주변 아티팩트·관계·코멘트 집계
clawket_get_recent_decisions	최근 결정사항 (artifact type=decision)

자세한 스펙은 Clawket DB의 아티팩트 ART-01KPCQ4ZPF0HHJ029WERJAHWD3 참조.

개발

pnpm install
pnpm build       # TypeScript → dist/
pnpm dev         # watch 모드

데몬 연결

• 기본: ~/.cache/clawket/clawketd.port에서 포트 읽기
• 오버라이드: CLAWKET_DAEMON_URL=http://localhost:PORT 환경변수

아키텍처 원칙

• 읽기 전용 — 상태 변경은 clawket CLI 책임
• 독립 패키지 — lattice-codex/ 코드 import 금지, HTTP API만 의존
• Pull 전용 — SessionStart 주입(Push)과 상호 보완, 중복 결과는 _already_injected 마킹

라이선스

MIT