How do I install Localmind?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Localmind need an API key?

No required environment variable is listed on this record.

What transport does Localmind use?

Localmind runs locally over stdio.

When was Localmind last checked?

Last checked 2026-10-28. 🧠 내 AI에게 '나'를 기억시키는 로컬 second-brain — 결정의 선택·이유·전제를 .md 노트로 남기고, MCP로 어떤 AI 앱(Claude Code·Desktop·Cursor)에서든 꺼내 쓰는 개인 기억 계층. 전부 로컬(Ollama 임베딩)·오픈소스.

Localmind MCP 服务器

接入你的智能体

添加此服务器

Install from the publisher. Not a PlugMCP endpoint.

在 PlugMCP 上运行

用我们的密钥与日志托管一份副本。

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

在 PlugMCP 上运行

用我们的密钥与日志托管一份副本。

这是你新建的服务器，不是此条目的官方端点。若要用发布方的 URL 与凭证，请使用上方安装面板。

启动

Server facts

Local

Transport: stdio
License: MIT
Last checked: 2026-10-28

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

localmind

localmind는 내 AI에게 "나"를 기억시키는 로컬 기억 계층입니다. 🧠

누구나 AI에게 일을 맡기는 시대 — 그런데 AI는 매번 내가 누구인지, 무엇을 왜 결정했는지 모른 채 새로 시작합니다. localmind를 붙이면 어떤 AI 앱(Claude Code·Claude Desktop·Cursor…)에서든 대화의 부산물로 결정·지식·맥락이 내 .md 노트로 저장되고, 다음 세션의 AI가 그 기억을 가지고 시작합니다. 노트는 전부 내 컴퓨터의 파일이고, git으로 백업·동기화됩니다.

처음이라 용어가 낯설다면 → 👉 5분 비유로 이해하기 부터 보세요.

무엇을 해주나요?

📝 기억해 둡니다 — 대화 중 "이거 기록해둬" 하면 AI가 노트로 저장합니다(capture_note). 결정은 선택·이유·전제 3층으로 남깁니다 — 왜 그렇게 결정했는지(why)가 가장 값진 기록입니다.
🔍 의미로 찾아줍니다 — "그거 뭐였지?" 하면 내 노트를 의미 기반으로 검색합니다(search_notes).
🧭 가지고 시작하게 합니다 — 새 세션의 AI가 작업 주제로 브리핑을 받아, 과거 결정을 이미 알고 시작합니다(brief). "이 프로젝트 뭐 하고 있었지?"를 물을 필요가 없어집니다.
⏳ 낡으면 알려줍니다 — 결정이 딛고 선 전제가 오래되면, 그 주제를 다시 만지는 순간 한 줄로 재검증을 권합니다(비차단 — 흐름을 막지 않습니다).
🖥️ 기기를 넘어 다닙니다 — 노트는 git 백업/복구로 어느 기기에서든 같은 기억(whoami로 확인).
🔒 전부 로컬 — 데이터는 내 컴퓨터에만. 중앙 서버·공유 계정·클라우드 저장 없음.

누구를 위한 건가요?

AI에게 일을 맡기는 사람 모두 — 개발자가 아니어도 됩니다. 이 도구를 실제로 조작하는 것은 사람이 아니라 AI입니다: 사람은 평범한 대화로 맡기기만 하면("기록해둬 / 찾아줘"), AI가 기록하고·찾아보고·브리핑 받으며 내 맥락 위에서 일을 더 잘하게 됩니다. 그렇게 내 지식·결정이 내 컴퓨터에 차곡차곡 쌓이는 나만의 두뇌가 생깁니다.

시작하기

make setup 명령 하나가 준비물 점검·설치·연결을 한국어로 한 단계씩 안내해 줍니다. 막히면 FAQ를 보세요.

준비물: Node.js ≥ 20 · 임베딩 엔진 Ollama (맥: brew install ollama, 컨테이너 대안: docker compose up -d).

git clone https://github.com/shaul1991/localmind && cd localmind
make setup      # 👈 이거 하나 — 준비물·진단·설치·연결을 단계별 안내

임베딩 설정(.env — make setup이 안내):

EMBEDDINGS_URL=http://localhost:11434/v1   # Ollama 직결
EMBEDDINGS_MODEL=bge-m3
EMBEDDINGS_KEY=dummy
NOTES_DIR=~/my-notes                        # 내 .md 노트 폴더(쉼표로 여러 개)

🖥️ 터미널이 처음이라 막막하다면 — clone 후 make guide를 실행하면 브라우저에 시각적 설치 가이드가 열립니다. 배지로 준비물 상태를 보고, 단계별 명령을 [복사]해 붙여넣기만 하면 돼요.

설치가 끝나면 → 👉 첫 사용 튜토리얼 (5분)

MCP로 연동할 수 있는 앱과 설정법

앱(MCP 호스트)	연동 한 줄
Claude Code	`make mcp-install`
Claude Desktop	`make mcp-desktop` — 설정 자동 병합·백업(붙여넣기 불필요)
Cursor · Cline	`make mcp-config` → 출력된 JSON을 설정 파일에 붙여넣기

내 .md 노트 폴더를 두뇌로 삼으려면 명령 뒤에 NOTES_DIR=/내/노트/폴더(쉼표로 여러 개).
적용 전 미리보기 DRY_RUN=1 make mcp-desktop · 도구 4종·환경변수 상세 → MCP로 붙이기.
기본은 기기마다 로컬(stdio). 원격(http) 옵션도 있어요 → 홈서버 가이드.

📚 더 알아보기

처음이라면 (비개발자 우선)

🎓 첫 사용 튜토리얼(5분) — MCP 연결 → 첫 노트 적재 → 찾아보기
🧩 비유로 이해하기 — 5분에 큰 그림
❓ 자주 묻는 질문(FAQ) — 설치·연동·백업·성능
📖 사용법 — 매일 "기록해둬 / 찾아줘"

더 파고들기 (개발자)

🛠️ 레퍼런스 — 동작 원리·색인·환경변수
🔌 MCP로 붙이기 — Cursor/Claude Desktop/Cline 연동 + 도구 4종
💾 백업 · 복구 — 내 노트를 git repo로, 새 기기 한 줄 복구
🏠 홈서버(옵션) — 원격 MCP로 여러 기기에서 한 두뇌 쓰기
📐 Product Vision — 이 프로젝트가 지향하는 것("살아있는 why 저장소")
🩺 문제 해결 — 잘 안 될 때 증상별 해결

🧰 SDD 워크플로 등 AI 작업 방법론은 이 저장소에 없습니다 — localmind는 기억 계층(코어)만 담당합니다(2026-07 great-reduction — rebuild-plan 참고). 방법론은 애드온으로 갈라져 나가, AI 런타임(Claude Code 등)에 필요한 것만 골라 설치하는 형태가 됐습니다 — localmind-core(세션 시작 브리핑·결정 3층 캡처), sdd-5docs(goal→spec→ plan→tasks→review 문서 체계), goal-impl(문서에서 구현으로). 모든 애드온의 기준은 두 가지 — localmind와 연결될 것, 그리고 형식으로 모델을 제약하지 말 것("무엇이 남아야 하는가"만 정하고 "어떻게"는 모델에 맡깁니다). 현재 별도 비공개 저장소에서 다듬는 중이며, localmind 없이도 이 저장소만으로 기억 계층은 온전히 동작합니다.

🔒 안전한가요? (개인 전용)

이 도구는 내 PC에서 나 혼자 쓰는 용도입니다. 노트·색인·검색 전부 로컬 파일이고, 외부로 나가는 것은 임베딩 호출(기본: 같은 컴퓨터의 Ollama)뿐입니다. 원격(http) 모드를 켤 때만 토큰 인증이 활성화됩니다.

라이선스

MIT — "있는 그대로(AS IS)" 무보증.

添加此服务器

用我们的密钥与日志托管一份副本。

Server facts

Tools

Questions

How do I install Localmind?

Does Localmind need an API key?

What transport does Localmind use?

When was Localmind last checked?

Documentation

localmind

무엇을 해주나요?

누구를 위한 건가요?

시작하기

📚 더 알아보기

🔒 안전한가요? (개인 전용)

라이선스