Which integrations are available for this server?

Uses MinIO as an object store for images and files, enabling storage, retrieval, and management of binary data with object lock support. Provides bidirectional synchronization with Obsidian vaults using YAML frontmatter for syncing notes and memory items.

How do I use zime-memory?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@zime-memory Remember my SSH key is in ~/.ssh/id_rsa" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

zime-memory

by zime78

Overview Schema Source Related Servers Discussions Admin

TypeScript

Hybrid

zime-memory

Qdrant + MinIO + SQLCipher 기반 Multi-Store 개인 메모리 MCP 서버

License: MIT Node.js MCP

Claude Code에서 자연어로 메모리를 저장하고, 의미 기반 유사도 검색으로 다시 찾을 수 있는 개인 메모리 시스템입니다.

Architecture

┌─────────────────────────────────────────────────────────────┐
│                      Claude Code (MCP Client)               │
│                                                             │
│   "Docker 네트워크 설정 방법 저장해줘"                         │
│   "API 키 저장해줘"  /  "스크린샷 보관해줘"                    │
└───────────────────────────┬─────────────────────────────────┘
                            │ MCP Protocol (stdio)
                            ▼
┌─────────────────────────────────────────────────────────────┐
│                  zime-memory MCP Server                     │
│                                                             │
│  ┌─────────┐  ┌──────────┐  ┌──────────┐  ┌────────────┐  │
│  │  19 MCP │  │  Store   │  │ Embedding│  │   Safety   │  │
│  │  Tools  │──│  Router  │  │ Service  │  │  Service   │  │
│  └────┬────┘  └────┬─────┘  └────┬─────┘  └────────────┘  │
│       │            │             │                          │
│       ▼            ▼             ▼                          │
│  ┌─────────────────────────────────────────────────────┐   │
│  │              Store Operations Layer                 │   │
│  │                                                     │   │
│  │  ┌───────────┐  ┌──────────┐  ┌──────────────┐    │   │
│  │  │ generalOps│  │ fileOps  │  │  secretOps   │    │   │
│  │  │ (텍스트)  │  │(이미지/  │  │ (API 키/     │    │   │
│  │  │           │  │  파일)   │  │  비밀번호)   │    │   │
│  │  └─────┬─────┘  └────┬─────┘  └──────┬───────┘    │   │
│  └────────┼──────────────┼───────────────┼────────────┘   │
└───────────┼──────────────┼───────────────┼────────────────┘
            │              │               │
            ▼              ▼               ▼
┌───────────────┐  ┌──────────────┐  ┌──────────────┐
│    Qdrant     │  │    MinIO     │  │  SQLCipher   │
│  Vector DB    │  │ Object Store │  │ Encrypted DB │
│               │  │              │  │              │
│ - 벡터 임베딩 │  │ - 바이너리   │  │ - AES-256    │
│ - 메타데이터  │  │ - Object Lock│  │ - 암호화 저장│
│ - 유사도 검색 │  │ - Presigned  │  │ - 개별 CRUD  │
│               │  │   URL        │  │              │
└───────────────┘  └──────────────┘  └──────────────┘
     (Docker)          (Docker)        (로컬 파일)

┌─────────────────────────────────────────────────┐
│           Embedding Provider (선택)              │
│                                                  │
│  ┌───────────┐ ┌────────────┐ ┌──────────────┐  │
│  │  Ollama   │ │   Local    │ │     Off      │  │
│  │ (bge-m3)  │ │(transformers│ │ (키워드만)   │  │
│  │ 1024차원  │ │  .js 384d) │ │ 임베딩 없음  │  │
│  │  기본값   │ │ Ollama불필요│ │              │  │
│  └───────────┘ └────────────┘ └──────────────┘  │
│         EMBEDDING_PROVIDER 환경변수로 선택        │
└─────────────────────────────────────────────────┘

원격 접속 모드 (Remote Access Mode)

SSH 터널을 통해 원격 Docker 서비스에 연결하고, 로컬 읽기 캐시로 오프라인 폴백을 제공한다.

┌─────────────────────────────────────────────────────────────┐
│               클라이언트 (현재 컴퓨터)                        │
│                                                             │
│  MCP Server ──SSH 터널──→ Mac Mini Docker                   │
│     │                      ├── Qdrant (6333)                │
│     │                      ├── MinIO  (9000)                │
│     │                      └── Ollama (11434)               │
│     │                                                       │
│     ├── 로컬 SQLCipher (secrets, 항상 로컬)                  │
│     └── 로컬 캐시 DB (오프라인 읽기 폴백)                     │
└─────────────────────────────────────────────────────────────┘

모드	조건	읽기	쓰기
온라인	SSH 터널 정상	원격 직접 + 캐시 저장	정상
오프라인	SSH 터널 끊김	캐시 읽기 전용	차단 (secrets 제외)

서버/클라이언트는 동일 코드. .env의 CACHE_ENABLED로 구분한다.

운영 모드 비교

	기본 모드 (로컬 Docker)	원격 접속 모드 (SSH 터널)
대상	단일 머신 사용자	멀티 머신 (서버 + 클라이언트)
설정	`./install.sh` 만으로 완료	`.env`에 `CACHE_ENABLED=true` + `ZIME_SSH_HOST`
Docker	로컬에서 실행	원격 서버에서 실행
Ollama	로컬에서 실행	원격 서버에서 실행
오프라인	Docker 실행 중이면 항상 동작	SSH 터널 끊기면 캐시 읽기만 가능
장점	설정 간단, 네트워크 불필요	리소스 절약, 여러 컴퓨터에서 접근
적합 환경	데스크톱 1대	노트북 + 서버, 외부에서 접근 필요

Related MCP server: mcp-server-claude

Quick Start

# 1. 프로젝트 클론
git clone https://github.com/zime78/zime-memory.git
cd zime-memory

# 2. 자동 설치 (Docker, Ollama, Node.js, 키 생성 포함)
./install.sh

# 3. Claude Code 재시작 후 사용
# "테스트 메모리 저장해줘" → memory_save
# "테스트 검색해줘" → memory_search

수동 설치는 아래 Installation 참고. 원격 접속 모드(SSH 터널)는 원격 접속 설정 참고.

Features

4개 Store

Store	Backend	용도	보안
general	Qdrant	텍스트 메모, 지식, 코드 스니펫	벡터 유사도 검색
images	MinIO + Qdrant	이미지, 스크린샷, 다이어그램	Object Lock (30일)
files	MinIO + Qdrant	문서, 설정 파일, 바이너리	Object Lock (30일)
secrets	SQLCipher	API 키, 토큰, 비밀번호	AES-256 전체 DB 암호화

19개 MCP 도구

도구	설명
`memory_save`	메모리 저장 (자동 임베딩, 중복 감지)
`memory_search`	의미 기반 유사도 검색 (크로스 스토어 지원)
`memory_get`	단건 상세 조회 (관련 메모리 추천)
`memory_list`	필터 기반 목록 조회 (페이지네이션)
`memory_update`	메모리 수정 (임베딩 자동 재생성)
`memory_delete`	단건 삭제
`memory_count`	건수 조회 (그룹별 분류)
`memory_stats`	4개 스토어 통합 통계
`memory_export`	JSON 내보내기
`memory_import`	JSON 가져오기 (중복 건너뛰기)
`memory_bulk_delete`	필터 기반 일괄 삭제
`memory_link`	메모리 간 관계 설정
`memory_summarize`	LLM 기반 카테고리 요약
`memory_backup`	Qdrant + MinIO + SQLCipher 통합 백업, SSH 원격 백업
`memory_restore`	soft-delete 복원, DB 복원
`memory_download`	이미지/파일 다운로드 (Presigned URL)
`memory_reindex`	임베딩 모델 변경 시 벡터 재생성
`memory_migrate`	기존 데이터 store 태그 마이그레이션
`memory_obsidian_sync`	Obsidian vault 양방향 동기화

주요 특징

3-Mode 임베딩 — Ollama(기본), 로컬(transformers.js), Off(키워드만) 선택 가능
의미 기반 검색 — 정확한 키워드 불필요, "Docker 설정" 검색 시 "docker compose 네트워크 구성" 결과 반환
크로스 스토어 검색 — store: "all"로 4개 스토어 통합 검색
Obsidian 연동 — YAML frontmatter 기반 양방향 동기화
자동 백업 — NAS 복사, 스냅샷 프루닝 (최대 20개)
SSH 원격 백업 — 시크릿 2중화, rsync 기반 원격 호스트 백업 + 스냅샷 관리
Draft & TTL — 임시 저장, 자동 만료
메모리 연결 — 계층 구조 (parentId) + 네트워크 구조 (relatedIds)
원격 접속 모드 — SSH 터널 기반 원격 Docker 연결 + 읽기 캐시 오프라인 폴백

Prerequisites

도구	버전	용도
Node.js	>= 18	런타임
Docker	latest	Qdrant, MinIO 컨테이너
Ollama	latest	임베딩 모델 (기본: bge-m3, `EMBEDDING_PROVIDER=local` 시 불필요)
Claude Code	latest	MCP 클라이언트

Installation

GitHub Clone (권장)

git clone https://github.com/zime78/zime-memory.git
cd zime-memory
./install.sh

Archive Install

tar xzf zime-memory-installer.tar.gz
cd zime-memory
./install.sh

install.sh 자동 실행 내용

Phase	내용	미설치 시
1. 필수 도구 확인	Docker, Node.js, Ollama, jq	Y/n 확인 후 자동 설치 (macOS brew / Linux)
2. 소스 배치 + .env	설치 위치 복사, 환경변수 생성	MinIO/SQLCipher 키 자동 생성
3. Docker 시작	Qdrant + MinIO 컨테이너	macOS: Docker Desktop 자동 실행
4. 빌드	`npm install` + TypeScript 빌드	-
5. Ollama 모델	bge-m3 (1024차원) 다운로드	macOS: Ollama 서비스 자동 시작
6. Claude 설정	`settings.json` MCP 서버 등록	-
7. Skill 설치	`~/.claude/skills/` 에 SKILL.md 복사	-
8. 헬스체크	6개 항목 검증	-

Upgrade (기존 사용자)

cd ~/mcp/zime-memory
git pull
./install.sh

업그레이드 시 자동 처리:

.env 및 data/ 보존 (기존 키/데이터 유지)
소스 업데이트 → dist/ 정리 → 리빌드
SKILL.md 변경분만 업데이트
버전 비교 표시 (현재 → 새 버전)

Manual Install

# 1. Clone
git clone https://github.com/zime78/zime-memory.git
cd zime-memory

# 2. 환경변수 설정
cp .env.example .env
# .env 파일을 열어 실제 값 입력
# SQLCipher 키 생성: openssl rand -hex 32

# 3. Docker 서비스 시작
docker compose up -d

# 4. 빌드
npm install
npm run build

# 5. Ollama 임베딩 모델 설치
ollama pull bge-m3

# 6. Claude Code에 MCP 서버 등록
claude mcp add zime-memory node ~/mcp/zime-memory/dist/index.js

필수 키 생성 (install.sh 사용 시 자동 생성):
# MinIO 비밀번호
openssl rand -base64 24 | tr -d '/+=' | head -c 24
# SQLCipher 암호화 키 (64자 hex)
openssl rand -hex 32
생성된 값을 .env의 MINIO_SECRET_KEY, MINIO_ROOT_PASSWORD, ZIME_ENCRYPTION_KEY에 입력하세요.

원격 접속 설정 (클라이언트 모드)

# 1. autossh 설치
brew install autossh

# 2. SSH 키 인증 설정 (SSH config의 호스트명)
ssh-copy-id your-server

# 3. SSH 터널 시작
./scripts/ssh-tunnel.sh

# 4. launchd 자동시작 등록 (권장 — 재부팅 시 터널 자동 시작)
cp scripts/com.zime.memory-tunnel.plist.example scripts/com.zime.memory-tunnel.plist
# com.zime.memory-tunnel.plist 내 "your-server"를 SSH config Host명으로 변경
ln -sf ~/mcp/zime-memory/scripts/com.zime.memory-tunnel.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.zime.memory-tunnel.plist

# 5. Mac Mini .env에서 캐시 비활성화
# CACHE_ENABLED=false

Configuration

.env.example을 .env로 복사하고 값을 설정합니다:

cp .env.example .env

변수	필수	기본값	설명
`EMBEDDING_PROVIDER`		`ollama`	임베딩 프로바이더: `ollama`, `local`, `off`
`QDRANT_URL`		`http://localhost:6333`	Qdrant 연결 URL
`OLLAMA_URL`		`http://localhost:11434`	Ollama 서비스 URL (ollama 모드)
`EMBEDDING_MODEL`		`bge-m3`	Ollama 임베딩 모델 (ollama 모드)
`LOCAL_EMBEDDING_MODEL`		`Xenova/all-MiniLM-L6-v2`	로컬 임베딩 모델 (local 모드, 384차원)
`MINIO_ACCESS_KEY`	*		MinIO 접근 키 (images/files 사용 시)
`MINIO_SECRET_KEY`	*		MinIO 비밀 키 (images/files 사용 시)
`ZIME_ENCRYPTION_KEY`	*		SQLCipher 암호화 키 (secrets 사용 시)
`OBSIDIAN_VAULT_PATH`			Obsidian vault 경로
`NAS_BACKUP_PATH`			NAS 백업 경로
`SSH_BACKUP_HOST`			SSH 원격 백업 대상 호스트 (미설정 시 ZIME_SSH_HOST)
`SSH_BACKUP_PATH`		`~/zime-memory-backup`	원격 백업 저장 경로
`SSH_BACKUP_MAX_SNAPSHOTS`		`20`	원격 스냅샷 최대 보관 수
`CACHE_ENABLED`		`true`	읽기 캐시 활성화 (서버 모드에서 `false`)
`CACHE_MAX_AGE_DAYS`		`7`	캐시 최대 보관 일수
`CACHE_MAX_ENTRIES`		`2000`	캐시 최대 항목 수
`ZIME_SSH_HOST`			SSH 터널 대상 호스트 (SSH config의 Host명)

* = 해당 store 사용 시 필수. openssl rand -hex 32로 암호화 키를 생성하세요.

Usage

Claude Code에서 자연어로 사용합니다:

# 텍스트 저장
"Docker Compose에서 네트워크 설정하는 방법 저장해줘"

# 의미 기반 검색
"도커 네트워크 관련 메모 찾아줘"

# API 키 저장
"GitHub API 키 저장해줘" → secrets store 자동 라우팅

# 이미지 저장
"이 스크린샷 저장해줘" → images store 자동 라우팅

# 크로스 스토어 검색
"전체 검색: 인증 관련 모든 메모리"

# 통계 확인
"메모리 저장소 통계 보여줘"

Project Structure

zime-memory/
├── src/
│   ├── index.ts                 # MCP 서버 진입점
│   ├── config.ts                # Zod 환경변수 검증
│   ├── instructions.ts          # MCP instructions
│   ├── tools/
│   │   ├── registry.ts          # 19개 도구 레지스트리
│   │   ├── memorySave.ts        # 저장
│   │   ├── memorySearch.ts      # 검색
│   │   └── ...                  # 17개 추가 도구
│   ├── services/
│   │   ├── connectionMonitor.ts # 연결 상태 모니터
│   │   ├── cacheService.ts      # 읽기 캐시 (오프라인 폴백)
│   │   ├── qdrantService.ts     # Qdrant 벡터 DB
│   │   ├── minioService.ts      # MinIO 오브젝트 스토리지
│   │   ├── sqlcipherService.ts  # SQLCipher 암호화 DB
│   │   ├── embeddingService.ts  # 임베딩 Strategy Pattern (ollama/local/off)
│   │   ├── providers/
│   │   │   ├── ollamaProvider.ts   # Ollama REST API 프로바이더
│   │   │   ├── localProvider.ts    # @huggingface/transformers 로컬 프로바이더
│   │   │   └── noopProvider.ts     # Off 모드 (제로 벡터)
│   │   ├── backupService.ts     # 통합 백업 + SSH 원격 백업
│   │   ├── obsidianService.ts   # Obsidian 동기화
│   │   ├── safetyService.ts     # 워터마크 검증
│   │   ├── storeRouter.ts       # store 라우팅
│   │   └── stores/
│   │       ├── generalOps.ts    # general store (텍스트)
│   │       ├── fileOps.ts       # images/files store
│   │       └── secretOps.ts     # secrets store
│   ├── types/
│   │   └── index.ts             # 타입 정의
│   └── utils/
│       ├── logger.ts            # 로깅
│       └── response.ts          # 응답 유틸
├── scripts/
│   ├── check-expiry.cjs         # 시크릿 만료 알림 (Slack)
│   ├── test-setup.sh            # 테스트 데이터 생성
│   ├── ssh-tunnel.sh            # SSH 터널 자동 연결
│   ├── ssh-backup.sh            # SSH 원격 백업 (시크릿 2중화)
│   └── com.zime.memory-tunnel.plist.example  # launchd 자동시작
├── docker-compose.yml           # Qdrant + MinIO
├── install.sh                   # 자동 설치 스크립트
├── pack.sh                      # 배포 아카이브 생성
├── .env.example                 # 환경변수 템플릿
├── package.json
└── tsconfig.json

Security

보호 대상	방법
secrets store	SQLCipher AES-256 전체 DB 암호화
시크릿 검색/목록	`value` 필드 미포함 (명시적 `get`만 반환)
이미지/파일	MinIO Object Lock (GOVERNANCE 30일)
Docker 포트	`127.0.0.1` 로컬 바인딩
파일 경로	Path Traversal 검증
SQL 쿼리	파라미터 바인딩 + 화이트리스트 검증
import/bulk_delete	secrets store 미지원 (안전)
SSH 터널 통신	SSH 암호화 터널 (로컬 포트 바인딩)

Store Support Matrix

도구	general	images	files	secrets	all
save/get/update	O	O	O	O	-
delete	O	O	O	O	-
search	O	O	O	O	O
list/count	O	O	O	O	O
export	O	O	O	O	-
import	O	O	O	X	-
bulk_delete	O	O	O	X	-
download	-	O	O	-	-
link/summarize	O	-	-	-	-
reindex	O	-	-	-	-
obsidian_sync	O	-	-	-	-

Tech Stack

기술	용도
MCP SDK	Claude Code 통합 프로토콜
Qdrant	벡터 유사도 검색 엔진
MinIO	S3 호환 오브젝트 스토리지
SQLCipher	AES-256 암호화 SQLite
Ollama	임베딩 모델 (기본: bge-m3, local 모드 시 불필요)
@huggingface/transformers	로컬 임베딩 (local 모드, Ollama 불필요)
Zod	입력 스키마 검증
TypeScript	타입 안전 코드

License

MIT

This server cannot be deployed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

nexsusOAuth
io.github.dbnexsus
Private persistent memory for Claude, ChatGPT & Gemini via MCP - semantic search, zero-code setup.
Knowledge & Memory RAG Systems
2
MemoryRouter A
ai.memoryrouter
Persistent AI memory shared across Claude, ChatGPT, coding agents, and compatible MCP clients.
Knowledge & Memory Search
101
mcpOAuth
ai.butlerbrain
Persistent memory for AI assistants. Save once; recall from Claude, ChatGPT, or any MCP client.
Knowledge & Memory RAG Systems Workplace & Productivity
2
Living MemoryOAuth
to.viibe
An MCP memory server. One memory your agents share — across models, devices and apps.
Knowledge & Memory Autonomous Agents AI & Machine Learning
22

Related MCP Servers

MCP Memory Server
Knowledge & Memory RAG Systems
PlumyCat
A
license
Not graded
quality
D
maintenance
An MCP server that gives Claude persistent memory by storing conversation context, entities, and enabling semantic search across sessions.
Updated a year ago (2025-06-23 22:52 UTC)
6
1
MIT
mcp-server-claude
RAG Systems Knowledge & Memory
zcc-cddg-mx
A
license
Not graded
quality
D
maintenance
MCP Memory Server for Claude Code that provides persistent context across sessions using semantic search (RAG).
Updated 2 months ago (2026-06-29 19:22 UTC)
Apache 2.0
claude-memory
Knowledge & Memory Search Code Analysis
NathanNorman
A
license
Not graded
quality
C
maintenance
A persistent memory MCP server for Claude Code that enables long-term recall across sessions via hybrid search, code intelligence, and tools for reading/writing memory.
Updated 4 days ago (2026-09-08 22:47 UTC)
5
1
MIT
MCP Memory Server
Knowledge & Memory Search
imyashkale
A
license
Not graded
quality
D
maintenance
A simple memory storage server for Claude using the Model Context Protocol (MCP), enabling Claude to store and retrieve text memories across conversations.
Updated 10 months ago (2025-11-16 15:59 UTC)
6
MIT

zime-memory

Architecture

원격 접속 모드 (Remote Access Mode)

운영 모드 비교

Quick Start

Features

4개 Store

19개 MCP 도구

주요 특징

Prerequisites

Installation

GitHub Clone (권장)

Archive Install

install.sh 자동 실행 내용

Upgrade (기존 사용자)

Manual Install

원격 접속 설정 (클라이언트 모드)

Configuration

Usage

Project Structure

Security

Store Support Matrix

Tech Stack

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

MCP Memory Server

mcp-server-claude

claude-memory

MCP Memory Server