Repolode
제출하기
basicmachines-co

basicmachines-co/basic-memory

AI 어시스턴트가 MCP를 통해 일반 Markdown 파일로 된 노트를 읽고 쓸 수 있게 해 주는 로컬 우선 메모리 계층입니다.

GitHub에서 보기웹사이트
스타
4,509
포크
352
열린 이슈
76
마지막 커밋
8시간 전

어떤 프로젝트인가요?

Basic Memory는 AI 어시스턴트에 지속적으로 사용할 수 있는 메모리를 제공합니다. 지식은 디스크에 Markdown 파일로 저장되며, 각 노트는 관찰 항목(대괄호로 표시한 범주에 속하는 사실)과 관계(다른 노트로 연결되는 wikilink)로 이루어진 엔티티입니다. 사용자와 AI 클라이언트는 같은 파일을 읽고 쓰고 검색할 수 있으며, Obsidian이나 편집기에서 수정한 내용도 어시스턴트에 반영됩니다.

프로젝트는 Model Context Protocol을 통해 도구를 제공하므로 Claude Desktop, Claude Code, Codex CLI, Cursor, VS Code 및 기타 MCP 호환 클라이언트에서 사용할 수 있습니다. 기본적으로 로컬 SQLite 인덱스를 사용하며, 대체 백엔드로 Postgres도 지원합니다. 검색에는 전체 텍스트 검색과 의미 기반 벡터 순위 지정이 함께 사용되며, 선택적으로 cross-encoder 재순위 지정기로 결과를 다듬을 수 있습니다.

여러 기기 간 동기화와 백업을 지원하는 호스팅 클라우드 버전도 제공하지만, 로컬 설치 버전은 AGPL-3.0 라이선스이며 서버 없이 실행됩니다.

핵심 기능

  • 01지식을 wikilink와 frontmatter가 포함된 일반 Markdown 파일로 저장합니다.
  • 02Claude, Codex, Cursor, VS Code를 비롯한 모든 MCP 클라이언트에서 작동합니다.
  • 03노트에서 키워드 검색, 의미 기반 벡터 검색, 하이브리드 검색을 지원합니다.
  • 04벡터 검색 및 하이브리드 검색 결과에 선택적으로 cross-encoder 재순위 지정을 적용할 수 있습니다.
  • 05프로젝트 관리, 상태 점검, 가져오기, 도구 접근을 위한 CLI를 제공합니다.
  • 06로컬 SQLite에서 실행되며, Postgres 백엔드도 선택할 수 있습니다.

활용 사례

  • AI 채팅 세션이 바뀌어도 프로젝트 아키텍처 결정 사항과 맥락을 유지합니다.
  • 사용자와 AI 어시스턴트가 함께 편집할 수 있는 개인 지식 베이스를 만듭니다.
  • Claude나 ChatGPT의 이전 대화를 검색 가능한 노트로 가져옵니다.
  • AI 어시스턴트도 관리하는 노트를 Obsidian에서 편집합니다.

빠른 시작

  1. 1

    uv로 Basic Memory 설치하기

    uv tool install basic-memory --prerelease=allow
  2. 2

    AI 클라이언트 설정에 Basic Memory 서버 추가하기(Claude Desktop 예시)

  3. 3

    AI 클라이언트를 다시 시작하고 사용하기

사용 전 알아둘 점

  • 로컬 설치에는 uv로 관리되는 Python이 필요합니다.
  • AGPL-3.0 카피레프트 라이선스가 적용됩니다. 네트워크 서비스로 제공하는 경우 수정된 소스 코드를 공유해야 합니다.
  • FastMCP 프리릴리스 버전에 의존하므로 --prerelease=allow 플래그가 필요합니다. 지정하지 않으면 이전 버전이 설치됩니다.

포함된 컬렉션

Claude Code용 MCP 서버Claude Code 도구·스킬·플러그인MCP 서버프라이버시·로컬 퍼스트 도구오픈소스 개인 AI 에이전트정적 사이트 생성기 및 문서 도구

토픽

#ai#mcp#markdown#knowledge-management#local-first#llm#personal-agent#obsidian#claude#knowlege-graph

자주 묻는 질문

basic-memory은(는) 무엇인가요?
AI 어시스턴트가 MCP를 통해 일반 Markdown 파일로 된 노트를 읽고 쓸 수 있게 해 주는 로컬 우선 메모리 계층입니다. Basic Memory는 AI 어시스턴트에 지속적으로 사용할 수 있는 메모리를 제공합니다. 지식은 디스크에 Markdown 파일로 저장되며, 각 노트는 관찰 항목(대괄호로 표시한 범주에 속하는 사실)과 관계(다른 노트로 연결되는 wikilink)로 이루어진 엔티티입니다. 사용자와 AI 클라이언트는 같은 파일을 읽고 쓰고 검색할 수 있으며, Obsidian이나 편집기에서 수정한 내용도 어시스턴트에 반영됩니다.
basic-memory은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
basic-memory은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
basic-memory은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. basic-memory의 마지막 커밋은 2026년 11월 6일입니다.
basic-memory은(는) 어디에 사용할 수 있나요?
AI 채팅 세션이 바뀌어도 프로젝트 아키텍처 결정 사항과 맥락을 유지합니다. 사용자와 AI 어시스턴트가 함께 편집할 수 있는 개인 지식 베이스를 만듭니다. Claude나 ChatGPT의 이전 대화를 검색 가능한 노트로 가져옵니다. AI 어시스턴트도 관리하는 노트를 Obsidian에서 편집합니다.
basic-memory는 어떻게 설치하나요?
uv로 Basic Memory 설치하기: uv tool install basic-memory --prerelease=allow AI 클라이언트 설정에 Basic Memory 서버 추가하기(Claude Desktop 예시) AI 클라이언트를 다시 시작하고 사용하기
basic-memory은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/basicmachines-co/basic-memory

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트