sqlite-memory-mcp은(는) 무엇을 하나요?
SQLite 기반 MCP 메모리 서버로, WAL 동시성 안전성, FTS5 검색, 세션 추적, 작업 관리 및 크로스 머신 브리지 동기화를 제공합니다.
주요 기능
- WAL 동시성 안전성: Write-Ahead Logging 모드를 사용하여 다중 클라이언트가 동시에 쓰기 작업을 수행할 때도 데이터 무결성을 보장합니다.
- FTS5 검색: 전체 텍스트 검색(Full-Text Search)을 통해 메모리 내용을 빠르게 검색합니다.
- 세션 추적: 각 세션의 활동을 기록하고 추적하여 컨텍스트 손실을 방지합니다.
- 작업 관리: 작업(Task)을 생성, 업데이트, 완료 처리하며 상태를 지속적으로 추적합니다.
- 크로스 머신 브리지 동기화: 여러 머신 간에 메모리 데이터를 동기화하여 분산 환경에서 일관된 상태를 유지합니다.
지원 플랫폼
이 스킬은 MCP 프로토콜을 지원하는 모든 AI 에이전트 플랫폼에서 사용할 수 있습니다:
- Claude Code
- Cursor
- Codex
- 기타 MCP 호환 도구
사용 방법
초기화
sqlite-memory-mcp initialize --db-path /path/to/memory.db
메모리 저장
sqlite-memory-mcp store_memory --key "project-alpha" --value {"name": "Alpha 프로젝트", "status": "진행 중"}
메모리 검색
sqlite-memory-mcp search_memories --query "프로젝트 상태"
브리지 동기화
sqlite-memory-mcp sync_bridge --remote http://remote-server:8080 --local /path/to/memory.db
구성
환경 변수나 구성 파일을 통해 설정할 수 있습니다:
| 변수 | 설명 | 기본값 |
|---|---|---|
MEMORY_DB_PATH | SQLite 데이터베이스 파일 경로 | ./memory.db |
SYNC_INTERVAL | 브리지 동기화 간격 (초) | 60 |
MAX_MEMORIES | 최대 메모리 항목 수 | 10000 |
아키텍처
+-------------------+ +-------------------+
| 머신 A | | 머신 B |
| MCP 클라이언트 |<----->| MCP 클라이언트 |
+-------------------+ +-------------------+
| |
v v
+-------------------+ +-------------------+
| SQLite (WAL 모드) | | SQLite (WAL 모드) |
| + FTS5 인덱스 | | + FTS5 인덱스 |
+-------------------+ +-------------------+
| |
+---------- 브리지 동기화 -----+
개발 참고 사항
- SQLite WAL 모드는 다중 프로세스 읽기/쓰기를 지원하므로 동시성 요구사항이 있는 환경에 적합합니다.
- FTS5 인덱스는 텍스트 검색 성능을 최적화합니다. 대규모 메모리 저장소에서도 빠른 검색이 가능합니다.
- 브리지 동기화는 충돌 해결을 위해 최종 쓰기 승인(Last-Write-Wins) 정책을 사용합니다.
라이센스
MIT