LiteContext CLI

LiteContext CLI는 개인 지식을 위한 로컬 우선(local-first) 컨텍스트 엔진이자 MCP 서버입니다. 로컬 Markdown 또는 Obsidian 폴더를 인덱싱하고, 소스 인용을 보존하며, 호환되는 AI 클라이언트가 MCP를 통해 관련 로컬 컨텍스트를 검색할 수 있게 합니다.

데스크톱 애플리케이션, 브라우저, 클라우드 계정, localhost UI 없이 실행됩니다. 소스와 인덱스는 기본적으로 ~/.litecontext에 유지됩니다.

설치

Go 엔진은 현재 읽기 전용 호환성 프리뷰입니다. 기존 LiteContext v1 JSON 워크스페이스를 열고, Context Profile 경계를 적용하며, 런타임에 Node 없이 인용 검색, doctor, MCP stdio를 제공합니다:

go run ./cmd/litecontext doctor --workspace ~/.litecontext --json
go run ./cmd/litecontext search --workspace ~/.litecontext --query "project roadmap" --json
go run ./cmd/litecontext mcp serve --workspace ~/.litecontext

아직 소스, 프로필, SQLite를 작성하지는 않습니다. TypeScript CLI는 마이그레이션 기간 동안 해당 작업의 호환성 기준선으로 유지됩니다. 첫 번째 Go 바이너리 릴리스는 GitHub Releases와 Homebrew를 통해 배포될 예정이며, npm은 필수 제품 런타임이 아닙니다.

Related MCP server: ragi

현재 TypeScript CLI 기준선

litecontext source add ~/Documents/notes --source-id notes --name "Personal notes"
litecontext source list
litecontext doctor
litecontext serve --mcp

Obsidian 볼트의 경우 --source-type obsidian을 추가하세요. source add는 --no-default-profile이 제공되지 않는 한 기본 Context Profile을 생성합니다. source sync <id>를 사용하여 소스를 새로 고치고, source remove <id>를 사용하여 LiteContext의 로컬 인덱스와 레지스트리 항목만 제거하며 원본 파일은 절대 제거하지 않습니다.

MCP 구성

AI 클라이언트에 붙여넣을 수 있는 구성을 출력합니다:

litecontext mcp-config --global

서버 명령은 litecontext serve --mcp입니다. MCP 서버는 데스크톱 애플리케이션이 실행 중이 아닐 때 동일한 로컬 워크스페이스를 읽습니다.

워크스페이스 및 아키텍처

Local Markdown / Obsidian
  -> connectors and ContextItem normalization
  -> SQLite/FTS index + Context Profile
  -> LiteContext CLI / MCP stdio
  -> cited local context for an AI client

• @litecontext/core — 계약, 프로필, SQLite/FTS 인덱스, 검색.

• @litecontext/connectors — 이식 가능한 소스 커넥터.

• @litecontext/cli — 소스 수명주기 명령, 진단, MCP 서버.

개발

전환 저장소는 현재 TypeScript 기준선과 Go 읽기 전용 엔진을 모두 검증합니다. Go 1.24.1, Node 24.13–24.x, pnpm 10이 필요합니다.

pnpm install
pnpm check
pnpm audit:security

pnpm check는 두 구현 모두에 대해 공유 골든 픽스처 테스트를 실행합니다.

CONTRIBUTING.md, SECURITY.md, 타사 고지, 릴리스 가이드를 참조하세요.

라이선스

MIT