@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환경변수
아키텍처 원칙
- 읽기 전용 — 상태 변경은
clawketCLI 책임 - 독립 패키지 —
lattice-codex/코드 import 금지, HTTP API만 의존 - Pull 전용 — SessionStart 주입(Push)과 상호 보완, 중복 결과는
_already_injected마킹
라이선스
MIT