Logica Context

당신의 AI는 컨텍스트가 초기화되면 모든 것을 잊어버립니다. 하지만 Logica Context는 그렇지 않습니다.

빠른 시작 · 차별점 · 17가지 도구 전체 · 기여하기

모두가 겪는 문제

모든 MCP 컨텍스트 서버는 샌드박스에서 명령어를 실행하고, 요약을 반환하며, 토큰을 절약하는 동일한 작업을 수행합니다. 이는 기본 중의 기본입니다.

하지만 그 누구도 해결하지 못하는 문제는 다음과 같습니다:

• AI는 당신이 설명하기 전까지는 프로젝트의 존재조차 모릅니다. 매 세션마다 말이죠.

• 세션이 종료되면 지식도 사라집니다. 내일이면 다시 0부터 시작해야 합니다.

• 팀원이 어제 같은 코드베이스를 인덱싱했더라도, 당신은 그 정보에 접근할 수 없습니다.

• 파일 이름이 middleware.ts이기 때문에 "인증 코드 찾아줘"라고 해도 아무것도 찾지 못합니다.

• 자신이 얼마나 많은 컨텍스트를 소모했는지 알 수 없습니다. AI가 환각을 일으키기 시작할 때야 비로소 알게 됩니다.

• AI는 당신이 방금 3개의 커밋을 푸시했다는 사실을 모릅니다. 여전히 어제의 코드를 참조하고 있습니다.

Logica Context는 이 여섯 가지 문제를 모두 해결합니다.

차별점

1. 프로젝트 DNA

다른 도구들: AI는 매 세션마다 아무것도 모르는 상태로 시작합니다. 당신은 스택을 설명하느라 5분을 낭비합니다.

Logica Context: lctx_scan을 한 번만 호출하면 AI는 프로젝트의 언어, 프레임워크, 의존성, 폴더 구조, 패턴을 영구적으로 기억합니다. 인덱싱되고, 검색 가능하며, 자동화됩니다.

> lctx_scan

Project DNA: my-saas-app
  Stack: Node.js, TypeScript
  Frameworks: Next.js, Prisma, Tailwind CSS, Vitest
  Languages: TypeScript (142), JavaScript (23), SQL (8)
  Patterns: component-based, page-based routing, API layer, CI/CD
  Key files: package.json, tsconfig.json, Dockerfile, .env.example

이제 AI는 당신이 첫 마디를 떼기도 전에 프로젝트를 파악하고 있습니다.

2. 세션 간 메모리

다른 도구들: 세션이 끝나면 모든 것이 사라집니다. 매일 아침 컨텍스트를 다시 설명해야 합니다.

Logica Context: Supabase를 통해 세션 간 지식이 유지됩니다. 내일 새로운 세션을 열어도 AI는 당신이 무엇을 작업했는지, 무엇을 인덱싱했는지, 무엇을 검색했는지 이미 알고 있습니다. 중단했던 지점부터 바로 시작합니다.

이 기능을 제공하는 다른 MCP 서버는 없습니다.

3. 팀 지식 베이스

다른 도구들: 각 개발자는 고립되어 있습니다. 개발자 A가 코드베이스를 파악하는 데 30분을 쓰면, 개발자 B도 한 시간 뒤에 똑같은 짓을 합니다.

Logica Context: lctx_team_push와 lctx_team_search를 사용하세요. 개발자 A가 무언가를 인덱싱하면 개발자 B가 그것을 찾을 수 있습니다. Supabase를 통해 프로젝트별로 네임스페이스가 지정된 공유 지식 베이스를 구축합니다.

팀 전체가 집단적인 AI 메모리를 구축하게 됩니다.

4. 의미론적 검색 (Semantic Search)

다른 도구들: 키워드 매칭에 의존합니다. "인증(authentication)"을 검색하면 함수 이름에 "auth"가 없다는 이유로 verifyJWT()를 놓치게 됩니다.

Logica Context: lctx_semantic은 실제 임베딩(Voyage AI 또는 OpenAI)과 pgvector를 사용하여 유사도 검색을 수행합니다. 문자열이 아닌 의미로 검색하세요. "로그인은 어떻게 작동해?"라고 물으면 JWT 미들웨어, 세션 저장소, OAuth 흐름을 찾아냅니다.

FTS5 키워드 검색은 여전히 빠른 기본 검색 방식으로 제공됩니다. API 키가 있으면 의미론적 검색이 활성화됩니다.

5. 컨텍스트 예산 (Context Budget)

다른 도구들: AI가 정보를 잊기 시작할 때까지 자신이 얼마나 많은 컨텍스트를 소비했는지 알 수 없습니다.

Logica Context: lctx_budget은 실시간 대시보드를 보여줍니다:

# Context Budget

[▓▓▓▓▓▓▓▓▓▓▓▓▓▓······] 72% used

Tokens consumed: 144,000
Tokens saved:    38,500
Context limit:   200,000

## Recent Tool Usage
  Bash                 in:    2,400  out:    8,200
  Read                 in:    1,800  out:    4,100
  lctx_execute         in:      200  out:    6,300

⚠ WARNING: Context 72% full. Use lctx tools to save space.

토큰이 어디에 쓰이는지 정확히 파악할 수 있습니다. 너무 늦기 전에 최적화하세요.

6. Git 인식 인덱싱

다른 도구들: AI는 당신이 방금 코드를 푸시했는지 모릅니다. 2시간 전의 낡은 컨텍스트를 참조하고 있습니다.

Logica Context: lctx_git은 현재 브랜치, 최근 커밋, 스테이징된 파일, diff 요약을 인덱싱합니다. AI는 모든 세션을 무엇이 변경되었는지 아는 상태로 시작합니다.

> lctx_git

Branch: feat/auth-refactor
Ahead: 3 commits

## Staged (2)
  + src/middleware/jwt.ts
  + tests/auth.test.ts

## Recent Commits
  a3f8b2c refactor: extract JWT validation into middleware
  9e1d445 fix: session expiry race condition
  2b7a901 test: add auth integration tests

"내가 뭘 바꿨는지 확인해 줄래?"라고 물을 필요가 없습니다. AI는 이미 알고 있으니까요.

7. MCP 애그리게이터

다른 도구들: 8개의 MCP 서버를 로드하면 각각의 도구 정의가 컨텍스트에 추가됩니다. 어떤 것이 비용을 유발하는지 알 수 없습니다.

Logica Context: lctx_mcp는 .mcp.json을 읽어 활성화된 모든 서버를 나열하고, 컨텍스트 비용을 추정하며, 비활성화할 서버를 추천합니다.

> lctx_mcp

# MCP Servers

Active: 8
Estimated context cost per cycle: ~3,200 tokens

## Servers
  supabase               npx @supabase/mcp      ~800 tokens
  notion                 npx @notion/mcp         ~800 tokens
  logica-context         npx logica-context       ~150 tokens
  ...

## Recommendations
  - 8 MCP servers active. Consider disabling unused ones.
  - Heavy servers: supabase, notion. Each call uses ~800 tokens.

빠른 시작

{
  "logica-context": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "logica-context"]
  }
}

.mcp.json에 추가하고 AI를 재시작하세요. 끝입니다.

Supabase 활성화 (기능 2, 3, 4용)

SUPABASE_URL=https://your-project.supabase.co
SUPABASE_SERVICE_KEY=your-service-key

의미론적 검색 활성화 (기능 4)

VOYAGE_API_KEY=your-key    # or OPENAI_API_KEY

17가지 도구 전체

핵심 (10가지 도구 — 모든 컨텍스트 서버가 갖춰야 할 기능)

독점 (7가지 도구 — 다른 곳에는 없는 기능)

벤치마크

다른 도구들과의 비교

플랫폼

Claude Code, Cursor, Gemini CLI, VS Code Copilot, Codex, Kiro, Zed, OpenCode와 호환됩니다. 플랫폼별 설정은 configs/를 확인하세요.

보안

명령어 검증, 경로 제한, 출력 정제, 타임아웃이 포함된 샌드박스 실행을 지원합니다. SECURITY.md를 참조하세요.

개발

git clone https://github.com/Rovemark/logica-context.git
cd logica-context
npm install && npm test && npm run build

라이선스

MIT — 자유롭게 사용하세요.