LocalNest MCP

왜 LocalNest인가?

다른 모든 MCP 서버는 메모리 또는 코드 인텔리전스 중 하나를 선택하도록 강요합니다. 둘 다는 불가능하죠.

LocalNest는 이 세 가지 기둥을 모두 결합하여 사용자의 머신에서 완전히 실행되는 최초의 서버입니다:

LocalNest 비교

다른 어떤 MCP 서버도 이 세 가지 기둥을 모두 다루지 않습니다. 시장 현황은 다음과 같습니다:

메모리 전용 서버와의 비교

Mem0은 41k개의 스타와 2,400만 달러의 투자를 받았지만, 코드 인텔리전스가 없는 메모리 전용입니다. Basic Memory는 Obsidian과 통합되지만 코드를 검색할 수 없습니다. AgentMemory는 자동 캡처 후크가 있지만 코드 관련 기능은 전무합니다.

코드 인텔리전스 서버와의 비교

GitNexus(27k 스타)는 강력한 코드 검색 기능을 갖췄지만 메모리가 없습니다. claude-context(Zilliz, 5.9k 스타)는 Milvus 기반이지만 KG나 메모리가 없습니다. codebase-memory-mcp(DeusData)는 가장 가까운 경쟁자로, 단일 바이너리에 코드와 KG를 포함하지만 AI 메모리 계층이 없습니다.

전체 기능 매트릭스

LocalNest는 처음 세 행의 모든 항목을 충족하는 유일한 서버입니다.

빠른 시작

# Install
npm install -g localnest-mcp

# Setup workspace + embeddings
localnest setup

# Verify
localnest doctor

대화형 대시보드:

localnest dashboard

MCP 클라이언트 설정

설정 후, AI 클라이언트 설정에 다음을 추가하세요:

{
  "mcpServers": {
    "localnest": {
      "command": "localnest-mcp",
      "startup_timeout_sec": 30,
      "env": {
        "MCP_MODE": "stdio",
        "LOCALNEST_CONFIG": "~/.localnest/config/localnest.config.json",
        "LOCALNEST_INDEX_BACKEND": "sqlite-vec",
        "LOCALNEST_MEMORY_ENABLED": "true"
      }
    }
  }
}

Claude Code, Cursor, Windsurf, Cline, Continue, Gemini CLI 및 모든 MCP 호환 클라이언트와 작동합니다.

도구 모음

LocalNest는 74개의 전문 MCP 도구를 제공하며, 집중적인 모음으로 구성되어 있습니다:

전체 매개변수 참조: 도구 문서

에이전트 워크플로우

LocalNest는 AI 코딩 에이전트를 위한 기초 컨텍스트 계층으로 설계되었습니다:

• 콜드 스타트 — agent_prime은 관련 메모리, 최근 변경 사항 및 프로젝트 상태로 컨텍스트 창을 즉시 채웁니다.

• 심층 조사 — find는 코드 조각과 과거 설계 결정 전반에 걸쳐 단일 호출로 융합 검색을 실행합니다.

• 지속적 학습 — teach는 세션 전반에 걸쳐 지속되는 아키텍처 규칙을 저장하여 에이전트가 실수를 반복하지 않도록 합니다.

• 결과 캡처 — capture_outcome은 무엇이 효과적이었고 무엇이 그렇지 않았는지 기록하여 시간이 지남에 따라 경험 기반을 구축합니다.

엔터프라이즈급 품질

• OIDC Trusted Publishing을 통한 검증 가능한 npm 출처

• 모든 브랜치에 대한 Continuous CodeQL 정적 분석

• OpenSSF Scorecard 모니터링 및 선제적인 Dependabot 업데이트

문제 해결

직접적인 npm install -g git+https://...는 TAR_ENTRY_ERRORS와 함께 실패할 수 있습니다. 이는 알려진 npm 제한 사항입니다.

해결 방법: 클론, 팩, 설치

git clone https://github.com/wmt-mobile/localnest.git
cd localnest && npm pack
npm install -g ./localnest-mcp-*.tgz

cd $(npm root -g)/localnest-mcp && npm install --no-save @huggingface/transformers
localnest doctor

리소스

• 문서 — 전체 도구 참조, 아키텍처 및 가이드

• 비교 — 상세 경쟁 분석

• 아키텍처 — 검색 파이프라인 및 메모리 그래프 내부 구조

• 변경 로그 — 릴리스 기록

• 보안 — 취약점 공개 정책