/ 디렉터리 / 플레이그라운드 / Memory Bank MCP
← 모든 서버 ↗ GitHub
● 커뮤니티 alioshr 🔑 본인 키 필요

Memory Bank MCP

제작: alioshr · alioshr/memory-bank-mcp

중앙 집중식 메모리 뱅크 서버 — Cline/Cursor/Claude 메모리 파일을 프로젝트별로 범위가 지정된 하나의 폴더에 보관하여 경로 탐색으로부터 안전하게 보호합니다.

memory-bank-mcp는 Cline Memory Bank 패턴을 독립형 MCP 서버로 전환합니다. 루트 디렉터리를 가리키면 모든 프로젝트는 에이전트가 다섯 가지 간단한 도구를 통해 읽고, 쓰고, 업데이트하고, 나열할 수 있는 자체 메모리 뱅크 폴더를 갖게 됩니다. 여러 클라이언트(Claude Desktop, Cursor, Windsurf)가 동일한 표준 메모리를 공유하도록 설계되었으므로 IDE마다 별도의 복사본이 필요하지 않습니다.

▶ 데모 보기 📦 설치 💡 사용 사례

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

memory-bank-mcp.replay ▶ 준비됨
0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "memory-bank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ],
      "env": {
        "MEMORY_BANK_ROOT": "/path/to/memory/banks"
      }
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "memory-bank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ],
      "env": {
        "MEMORY_BANK_ROOT": "/path/to/memory/banks"
      }
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "memory-bank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ],
      "env": {
        "MEMORY_BANK_ROOT": "/path/to/memory/banks"
      }
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "memory-bank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ],
      "env": {
        "MEMORY_BANK_ROOT": "/path/to/memory/banks"
      }
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "memory-bank-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "memory-bank-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@allpepper/memory-bank-mcp"
        ]
      }
    }
  }
}

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

claude mcp add memory-bank-mcp -- npx -y @allpepper/memory-bank-mcp

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

사용 사례

실전 활용법: Memory Bank MCP

Claude Desktop, Cursor 및 Windsurf에서 하나의 메모리 뱅크 공유

👤 IDE 사이를 오가며 프로젝트 지식의 단일 소스를 원하는 개발자 ⏱ ~15 min beginner

언제 쓸까: 둘 이상의 AI 클라이언트를 사용하고 프로젝트에 대한 동일한 메모를 계속 다시 복사합니다.

사전 조건
  • 노드 18+ — nvm 설치 18
  • 메모리 뱅크를 보관하는 디렉토리 — mkdir -p ~/ai-메모리
흐름
  1. 각 클라이언트의 MCP 구성에서 MEMORY_BANK_ROOT를 설정합니다.
    MEMORY_BANK_ROOT=~/ai-memory에서 모든 MCP 클라이언트를 지정하고 @allpepper/memory-bank-mcp를 설치합니다.✓ 복사됨
    → memory_bank_* 도구가 각 클라이언트에 나타납니다.
  2. 첫 번째 프로젝트 뱅크 만들기
    memory_bank_write project=acme-api file=architecture.md — 이 저장소의 서비스 경계를 ​​요약합니다.✓ 복사됨
    → 파일은 ~/ai-memory/acme-api/architecture.md 아래에 나타납니다.
  3. 다른 클라이언트에서 읽기
    커서: memory_bank_read 프로젝트=acme-api 파일=architecture.md✓ 복사됨
    → 동일한 콘텐츠가 반환되었습니다. 두 클라이언트의 편집 내용이 즉시 표시됩니다.

결과: 모든 IDE가 자동으로 참조하는 공유되고 버전 지정이 가능한 메모리 폴더입니다.

함정
  • MEMORY_BANK_ROOT를 변경한 후 MCP 클라이언트를 다시 시작하는 것을 잊어버렸습니다. — 클라이언트를 닫았다가 다시 엽니다. env 변수는 시작 시에만 읽혀집니다.
함께 쓰기: filesystem · github

신규 상담원에게 장기 실행 프로젝트에 대한 즉각적인 상황 정보 제공

👤 동일한 코드베이스에서 여러 에이전트를 실행하는 팀 ⏱ ~10 min beginner

언제 쓸까: 새로운 채팅에는 마지막 채팅에서 이미 배운 것과 동일한 배경(규칙, 과거 결정, 알려진 버그)이 필요합니다.

사전 조건
  • 이 프로젝트의 기존 메모리 뱅크 — memory_bank_write를 사용하여 일반 작업 중에 채웁니다.
흐름
  1. 프로젝트 뱅크에 이미 있는 파일 목록을 나열합니다.
    project=acme-api에 대해 list_project_files를 호출합니다.✓ 복사됨
    → Architecture.md, Decisions.md, open-questions.md 등
  2. 관련 하위 집합 로드
    작업을 시작하기 전에 Decisions.md 및 open-questions.md를 읽어보세요.✓ 복사됨
    → 상담원은 다시 묻는 대신 이전 결정을 참조합니다.

결과: 새로운 세션은 차갑게 시작되지 않고 따뜻하게 시작됩니다. 매번 탑승세 납부를 중단합니다.

함정
  • 은행이 하나의 거대한 파일로 성장하도록 허용 — 의사 결정, 아키텍처, 공개 질문, 실행서 등 관심사별로 분할되어 에이전트가 필요한 것만 로드합니다.
함께 쓰기: codebase-memory

다른 프로젝트 문서와 마찬가지로 git에서 에이전트 메모리 버전을 지정하세요.

👤 머신과 기여자 사이에서 메모리가 살아남기를 원하는 팀 ⏱ ~20 min intermediate

언제 쓸까: 메모리 파일을 검토하고, 비교하고, 팀원과 공유하기를 원합니다.

사전 조건
  • 은행을 호스팅하는 Git 저장소 — MEMORY_BANK_ROOT 또는 프로젝트 하위 폴더 내의 git init
흐름
  1. 루트를 저장소로 만들기
    ~/ai-memory를 git repo로 전환합니다. 민감한 내용에는 .gitignore를 추가하세요.✓ 복사됨
    → 표준 git repo 구조
  2. 세션 중에 에이전트가 메모리를 업데이트하도록 허용
    버그를 수정한 후 memory_bank_update를 호출하여 bugs.md에 근본 원인을 기록합니다.✓ 복사됨
    → 새로운 커밋 준비 diff
  3. 커밋 및 푸시
    메모리 차이를 검토하고 커밋하고 푸시합니다.✓ 복사됨
    → 팀원이 풀링하면 에이전트가 즉시 상황을 공유합니다.

결과: 에이전트 메모리는 일류 프로젝트 결과물이 됩니다.

함정
  • 에이전트가 기록한 비밀 커밋 — 메모리 저장소를 푸시하기 전에 사전 커밋 스캐너(예: gitleaks)를 추가하세요.
함께 쓰기: github · git

조합

다른 MCP와 조합해 10배 효율

memory-bank-mcp + filesystem

메모리 뱅크에는 상담원 메모가 보관됩니다. 파일 시스템은 참조하는 코드를 읽습니다.

메모리 뱅크에서 Decision.md를 읽은 다음 src/에서 참조하는 파일을 엽니다.✓ 복사됨
memory-bank-mcp + github

PR 병합 후 프로젝트의 메모리 뱅크에 결과를 기록합니다.

병합된 PR #412를 요약하고 memory-bank/acme-api/decisions.md를 업데이트합니다.✓ 복사됨
memory-bank-mcp + codebase-memory

두 개의 보완적인 메모리 계층 — 코드 그래프 메모리 + 사람이 읽을 수 있는 메모

코드베이스 메모리 기호 그래프를 memory-bank/architecture.md의 설명과 결합합니다.✓ 복사됨

도구

이 MCP가 노출하는 것

도구입력언제 호출비용
memory_bank_read project: str, file: str 계획하기 전에 기존 메모리 가져오기 0
memory_bank_write project: str, file: str, content: str 새로운 메모리 파일 만들기 0
memory_bank_update project: str, file: str, content: str 기존 메모리 파일 수정(누락된 경우 실패) 0
list_projects (none) 이미 메모리 뱅크가 있는 프로젝트를 찾아보세요. 0
list_project_files project: str 읽기 전에 어떤 메모리 파일을 사용할 수 있는지 확인하세요. 0

비용 및 제한

운영 비용

API 쿼터
외부 API 없음
호출당 토큰
파일 크기에 따라 다릅니다. 일반적인 노트 200-2000 토큰
금액
무료 — 로컬에서 실행
팁
메모리 파일을 짧고 주제 범위로 유지하세요. 50KB 파일을 로드하면 호출할 때마다 컨텍스트가 낭비됩니다.

보안

권한, 시크릿, 파급범위

자격 증명 저장: 자격 증명이 없습니다. MEMORY_BANK_ROOT 경로가 유일한 구성입니다.
데이터 외부 송신: 네트워크 호출 없음 - 읽기 및 쓰기는 MEMORY_BANK_ROOT 아래의 로컬 파일 시스템에 유지됩니다.

문제 해결

자주 발생하는 오류와 해결

오류: MEMORY_BANK_ROOT가 설정되지 않았습니다.

MCP 클라이언트 구성에서 env var를 설정하고 클라이언트를 다시 시작하십시오.

확인: echo $MEMORY_BANK_ROOT
파일을 읽을 때 ENOENT

list_project_files를 먼저 호출하세요. 파일 이름은 정확하게 존재해야 합니다.

확인: ls $MEMORY_BANK_ROOT/<project>/
쓰기 시 EACCES

MCP 프로세스에 MEMORY_BANK_ROOT에 대한 쓰기 권한이 있는지 확인하십시오.

확인: touch $MEMORY_BANK_ROOT/.probe && rm $MEMORY_BANK_ROOT/.probe

대안

Memory Bank MCP 다른 것과 비교

대안언제 쓰나단점/장점
memory (official)파일 기반 노트가 아닌 지식 그래프를 원합니다그래프는 구조화되어 있지만 사람이 편집할 가능성이 적습니다.
memory-service메모리에 대한 의미 검색을 원합니다.더 무거운 설정; 임베딩 필요
Cline Memory Bank (inline)Cline만 사용하며 IDE 간 공유가 필요하지 않습니다.Cline에 고정됨

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기