Stash MCP — 설치 & 라이브 데모

왜 쓰나요

핵심 기능

에피소드(타임라인) + 팩트(KV)
소형 Go 바이너리
임베딩 선택 사항
모든 저장소 검색
단일 파일로 백업

라이브 데모

실제 사용 모습

준비됨

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "stash-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "9000:9000",
        "ghcr.io/alash3al/stash:latest"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "stash-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "9000:9000",
        "ghcr.io/alash3al/stash:latest"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "stash-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "9000:9000",
        "ghcr.io/alash3al/stash:latest"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "stash-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "9000:9000",
        "ghcr.io/alash3al/stash:latest"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "stash-mcp",
      "command": "docker",
      "args": [
        "run",
        "-p",
        "9000:9000",
        "ghcr.io/alash3al/stash:latest"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "stash-mcp": {
      "command": {
        "path": "docker",
        "args": [
          "run",
          "-p",
          "9000:9000",
          "ghcr.io/alash3al/stash:latest"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add stash-mcp -- docker run -p 9000:9000 ghcr.io/alash3al/stash:latest

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Stash

세션 간 에이전트 메모리 유지

👤 개발자 ⏱ ~15 min intermediate

언제 쓸까: Claude가 선호사항과 최근 컨텍스트를 기억하게 하고 싶을 때.

흐름

stash 실행

docker run alash3al/stash✓ 복사됨

→ 서비스 실행됨
MCP 연결

Claude 설정에 stash를 MCP로 추가합니다.✓ 복사됨

→ 도구 표시됨
사용

remember "사용자가 JS보다 TypeScript를 선호함"; 나중에 recall.✓ 복사됨

→ 메모리 회상됨

결과: 메모리 SaaS 비용 없이 연속성 유지.

조합

다른 MCP와 조합해 10배 효율

stash-mcp + filesystem

메모리를 주기적으로 디스크에 덤프하여 백업

stash-mcp와 filesystem 조합: 메모리를 주기적으로 디스크에 덤프하여 백업✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
remember_episode	(문서 참조)	타임라인 이벤트 추가	호출 1회
remember_fact	(문서 참조)	지속 팩트 저장	호출 1회
search	(문서 참조)	두 저장소 모두 검색	호출 1회

비용 및 제한

운영 비용

API 쿼터: 로컬
호출당 토큰: 소량
금액: 무료 OSS
팁: 데이터 디렉토리를 정기적으로 스냅샷하세요

보안

권한, 시크릿, 파급범위

자격 증명 저장: 디스크의 DB

데이터 외부 송신: 기본값으로 없음

문제 해결

자주 발생하는 오류와 해결

임베딩 엔드포인트 없음

EMBEDDING_URL 설정 또는 키워드 전용 모드로 실행

대안

Stash 다른 것과 비교

대안	언제 쓰나	단점/장점
memsearch	Milvus 기반 스케일이 필요할 때	더 복잡한 설정

Stash