kagura-ai/memory-cloud

memory-cloud은(는) 무엇을 하나요?

범용 AI 메모리 플랫폼 — 원격 MCP 서버 + 웹 관리 UI. AI 어시스턴트에게 대화 간 지속적인 메모리를 제공합니다.

개요

kagura-ai/memory-cloud는 AI 에이전트가 여러 세션에 걸쳐 정보를 기억할 수 있게 해주는 원격 메모리 서버입니다. MCP(Model Context Protocol) 위에 구축되어 Claude Code, Cursor, Codex 및 기타 MCP 호환 도구와 함께 원활하게 작동합니다.

주요 기능

• 지속적 메모리: AI 어시스턴트가 대화 간 컨텍스트를 유지합니다.
• 원격 MCP 서버: 로컬 네트워크나 인터넷을 통해 모든 MCP 호환 클라이언트에서 접근 가능합니다.
• 웹 관리 UI: 메모리 콘텐츠를 쉽게 보고, 검색하고, 관리할 수 있는 브라우저 기반 인터페이스입니다.
• 다중 저장소 백엔드: 로컬 파일, SQLite, PostgreSQL 또는 클라우드 스토리지를 지원합니다.
• API 기반: REST, WebSocket, MCP 프로토콜을 포함한 여러 통합 방법을 제공합니다.

설치

npm install -g @kagura-ai/memory-cloud
# 또는
npx @kagura-ai/memory-cloud

빠른 시작

1. 서버 시작:

memory-cloud start --port 3000

2. 웹 UI에 접속: http://localhost:3000

3. MCP 클라이언트에 연결:

   {
     "mcpServers": {
       "memory-cloud": {
         "url": "http://localhost:3000/mcp"
       }
     }
   }
   

MCP 도구

서버는 다음과 같은 MCP 도구를 노출합니다:

• store_memory: 나중에 검색할 수 있도록 메모리 항목을 저장합니다.
• retrieve_memory: 저장된 메모리를 키 또는 세션별로 검색합니다.
• search_memories: 저장된 모든 메모리에서 키워드를 검색합니다.
• delete_memory: 더 이상 필요하지 않은 메모리 항목을 제거합니다.
• list_sessions: 모든 활성 메모리 세션을 나열합니다.

구성

환경 변수를 통해 구성:

변수	기본값	설명
MEMORY_STORAGE	local	스토리지 백엔드 (local, sqlite, postgres)
MEMORY_DB_PATH	./data	로컬 데이터베이스 파일 경로
PORT	3000	서버 HTTP 포트
JWT_SECRET	(자동 생성)	API 인증용 JWT 시크릿

웹 UI

웹 관리 UI는 다음을 제공합니다:

• 메모리 항목 대시보드 보기
• 키워드별 메모리 검색 및 필터링
• 개별 메모리 항목 추가, 편집 및 삭제
• 연결된 AI 에이전트의 실시간 활동 로그

라이선스

MIT