@clawket/mcp

MCP (Model Context Protocol) server for Clawket.

A stdio server that allows LLMs to explore Clawket's RAG repository via pull-based tool_use. It handles exploratory and conditional queries that fixed injection (Push) in the SessionStart hook cannot cover.

Status

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

Tools have not been implemented yet. It only responds to stdio handshakes after build.

Installation

It is automatically installed alongside the Clawket CLI (since CK-302).

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

Execution

Automatic startup as a Claude Code plugin (Recommended, since CK-303)

Installing the Seungwoo321-clawket plugin will automatically register .mcp.json.

Manual execution

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

Exposed Tools (Planned)

For detailed specifications, refer to artifact ART-01KPCQ4ZPF0HHJ029WERJAHWD3 in the Clawket DB.

Development

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

Daemon Connection

• Default: Read port from ~/.cache/clawket/clawketd.port

• Override: CLAWKET_DAEMON_URL=http://localhost:PORT environment variable

Architectural Principles

• Read-only — State changes are the responsibility of the clawket CLI

• Independent Package — Importing lattice-codex/ code is prohibited; rely only on HTTP API

• Pull-only — Complements SessionStart injection (Push); duplicate results are marked as _already_injected

License

MIT