AI 및 LLM에이전트

MCP를 통한 AI 어시스턴트용 메모리

하나의 MCP 서버로 Claude, Cursor, VS Code 또는 자체 에이전트에 메모리, 노트, 이벤트 로그, 프롬프트 템플릿, 문서 검색을 제공합니다.

고정된 도구: 28
임의 명령: 0
오픈 소스: Apache-2.0

단계 1 / 5

서버 연결

명령 하나로 Claude Code에 HotKV를 추가합니다. Cursor와 Claude Desktop은 대신 mcpServers 항목을 사용합니다.

예시 세션playing

# 서버 연결

$ claude mcp add hotkv -- uvx hotkv-mcp --url hotkv://localhost:6379 --namespace team-docs

(hotkv added as an MCP server)

실제 HotKV 명령과 예시 응답으로 구성된 애니메이션 안내입니다. 원하는 단계를 클릭하면 해당 단계로 이동합니다. 명령과 응답은 HotKV에서 입력하고 보는 그대로 영어로 표시됩니다.

문제

AI 어시스턴트는 채팅이 끝나면 모든 것을 잊어버리며, 이를 해결하려고 데이터베이스에 대한 원시 접근 권한을 주는 것은 위험합니다. 모델이 잘못된 명령 하나만 실행해도 데이터를 지우거나 다른 테넌트의 키를 읽을 수 있습니다.

HotKV의 해결 방식

hotkv-mcp는 어시스턴트에 28개의 고정된 도구를 제공합니다. 키, 해시, 리스트, 대화 메모리, 작업 노트, 이벤트 로그, 롤링 요약, 프롬프트 레지스트리, 문서 검색을 다룹니다. 임의 명령을 실행하는 도구는 없으며, 네임스페이스가 에이전트를 하나의 프리픽스 안에 가두고, 읽기 전용 모드는 모든 쓰기 도구를 제거합니다.

단계별 설명

명령 하나하나, 무슨 일이 일어나는가

01
서버 연결
명령 하나로 Claude Code에 HotKV를 추가합니다. Cursor와 Claude Desktop은 대신 mcpServers 항목을 사용합니다.
claude mcp add hotkv -- uvx hotkv-mcp --url hotkv://localhost:6379 --namespace team-docs
02
"릴리스 체크리스트를 기억해 줘"
어시스턴트가 memory_set_note 도구로 작업 노트를 저장합니다. 노트는 team-docs 프리픽스 아래에 들어갑니다.
tool memory_set_note {"session": "releases", "key": "checklist", "value": "1. bump version 2. changelog ..."}
03
다음 주, 새 채팅에서
새 대화에는 기록이 없지만 노트는 여전히 HotKV에 있습니다.
tool memory_get_note {"session": "releases", "key": "checklist"}
04
팀 문서 검색
rag_ingest로 수집한 문서는 키워드 관련성으로 검색되므로 임베딩 모델이 필요 없습니다.
tool rag_search {"pipeline": "runbooks", "query": "rotate TLS certificates", "k": 3}
05
다른 팀은 접근 불가
모든 이름은 team-docs: 아래에 저장되므로, 이 요청은 존재하지 않는 team-docs:other-team:secrets를 가리킵니다. 다른 팀의 키는 이름조차 지정할 수 없으며, 데이터베이스를 비우거나 원시 명령을 실행하는 도구도 없습니다.
tool delete {"key": "other-team:secrets"}

적용 분야

실제 시나리오

엔지니어링 팀

공유된 읽기 전용 MCP 서버로 모든 개발자의 어시스턴트가 같은 런북과 설계 노트를 검색합니다.

개인 어시스턴트

선호, 진행 중인 작업, 결정 사항을 노트와 요약으로 보관하므로 어시스턴트가 중단한 지점부터 이어 갑니다.

에이전트 플랫폼

각 고객의 에이전트는 하나의 서버에서 자체 네임스페이스를 받으며, 다른 고객의 것은 볼 수 없습니다.

내장 기능

제공되는 기능

고정된 안전한 도구 세트

28개의 도구가 있으며 임의 명령을 실행할 방법은 없습니다. 각 도구는 읽기, 쓰기, 삭제 중 무엇을 하는지 선언합니다.

네임스페이스

--namespace는 에이전트를 에이전트 자신은 볼 수 없는 하나의 프리픽스 안에 가둡니다. 각 에이전트에는 다른 에이전트 프리픽스의 시작 부분이 아닌 프리픽스를 주십시오.

읽기 전용 모드

--read-only를 사용하면 쓰기 도구가 아예 등록되지 않습니다.

제한된 결과

값과 리스트에 상한이 있으므로 거대한 값이 모델의 컨텍스트를 넘치게 할 수 없습니다.

Claude Desktop, Cursor 및 기타 mcpServers 클라이언트

json

{
  "mcpServers": {
    "hotkv": {
      "command": "uvx",
      "args": ["hotkv-mcp", "--read-only"],
      "env": { "HOTKV_URL": "hotkv://:your-password@localhost:6379" }
    }
  }
}

레퍼런스:hotkv-mcp on GitHub

자주 묻는 질문

어떤 클라이언트와 함께 동작합니까?

Claude Code, Claude Desktop, Cursor, VS Code를 포함한 모든 MCP 클라이언트입니다. 로컬 클라이언트에는 stdio를, 공유 사용에는 streamable HTTP를 사용합니다.

HotKV 라이선스가 필요합니까?

키, 해시, 리스트 도구는 어떤 서버에서도 동작합니다. 메모리, 프롬프트, 문서 검색 도구는 HotKV의 AI 엔진을 사용하므로 이를 포함하는 라이선스가 필요합니다.

HTTP 전송은 인증됩니까?

아닙니다. localhost에 두거나 인증을 수행하는 리버스 프록시 뒤에 두고, 가능하면 자체 네임스페이스와 읽기 전용 모드를 지정하십시오.

직접 워크로드로 사용해 보십시오

HotKV는 Redis 프로토콜을 사용하므로 기존 클라이언트를 연결해 같은 명령을 그대로 실행할 수 있습니다.

얼리 액세스 신청 다음: LLM 비용 거버넌스

MCP를 통한 AI 어시스턴트용 메모리

문제

HotKV의 해결 방식

명령 하나하나, 무슨 일이 일어나는가

서버 연결

"릴리스 체크리스트를 기억해 줘"

다음 주, 새 채팅에서

팀 문서 검색

다른 팀은 접근 불가