Memory Bank MCP Server

메모리 뱅크 MCP 서버

Cline Memory Bank 에서 영감을 받아 원격 메모리 뱅크 관리를 위한 MCP(Model Context Protocol) 서버 구현입니다.

개요

메모리 뱅크 MCP 서버는 기존 파일 기반 메모리 뱅크를 다음과 같은 기능을 제공하는 중앙 집중식 서비스로 변환합니다.

• MCP 프로토콜을 통해 메모리 뱅크 파일에 대한 원격 액세스를 제공합니다.
• 다중 프로젝트 메모리 뱅크 관리를 활성화합니다.
• 일관된 파일 구조와 검증을 유지합니다.
• 프로젝트 메모리 뱅크 간의 적절한 격리를 보장합니다.

특징

• 다중 프로젝트 지원
  • 프로젝트별 디렉토리
  • 파일 구조 적용
  • 경로 탐색 방지
  • 프로젝트 목록 기능
  • 프로젝트별 파일 목록
• 원격 접근성
  • 전체 MCP 프로토콜 구현
  • 유형 안전 작업
  • 적절한 오류 처리
  • 프로젝트 격리를 통한 보안
• 핵심 운영
  • 메모리 뱅크 파일 읽기/쓰기/업데이트
  • 사용 가능한 프로젝트 나열
  • 프로젝트 내 파일 나열
  • 프로젝트 존재 검증
  • 안전한 읽기 전용 작업

설치

Smithery를 통해 Claude Desktop용 Memory Bank Server를 자동으로 설치하려면:

지엑스피1

이렇게 하면 MCP 서버 구성이 자동으로 설정됩니다. 또는 아래 구성 섹션에 설명된 대로 서버를 수동으로 구성할 수 있습니다.

빠른 시작

1. 설정에서 MCP 서버를 구성하세요(아래 구성 섹션 참조)
2. AI 어시스턴트에서 메모리 뱅크 도구를 사용해보세요

구성

메모리 뱅크 MCP 서버는 Cline MCP 설정 파일에서 구성해야 합니다. 위치는 설정에 따라 다릅니다.

• Cline 확장의 경우: ~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Roo Code VS Code 확장: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
• Claude 데스크톱 앱의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json

MCP 설정에 다음 구성을 추가하세요.

구성 세부 정보

• MEMORY_BANK_ROOT : 프로젝트 메모리 뱅크가 저장될 디렉토리(예: /path/to/memory-bank )
• disabled : 서버를 활성화하려면 false 로 설정합니다.
• autoApprove : 명시적인 사용자 승인이 필요하지 않은 작업 목록:
  • memory_bank_read : 메모리 뱅크 파일을 읽습니다.
  • memory_bank_write : 새로운 메모리 뱅크 파일을 생성합니다.
  • memory_bank_update : 기존 메모리 뱅크 파일을 업데이트합니다.
  • list_projects : 사용 가능한 프로젝트 목록
  • list_project_files : 프로젝트 내의 파일 목록

커서용

커서의 경우 설정 -> 기능 -> MCP 서버 추가 -> 다음을 추가합니다.

사용자 정의 IA 지침

이 섹션에는 Cline, Claude, Cursor 또는 다른 MCP 클라이언트용 AI 사용자 지정 지침에 붙여넣어야 하는 지침이 포함되어 있습니다. 이 규칙들을 복사하여 붙여넣으세요. 자세한 내용은 이 규칙들이 포함된 custom-instructions.md 파일을 참조하세요.

개발

기본 개발 명령:

Docker로 실행

1. Docker 이미지를 빌드합니다.
   docker build -t memory-bank-mcp:local .
2. 테스트를 위해 Docker 컨테이너를 실행합니다.
   docker run -i --rm \ -e MEMORY_BANK_ROOT="/mnt/memory_bank" \ -v /path/to/memory-bank:/mnt/memory_bank \ --entrypoint /bin/sh \ memory-bank-mcp:local \ -c "ls -la /mnt/memory_bank"
3. MCP 구성 추가(Roo 코드의 예):
   "allpepper-memory-bank": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "MEMORY_BANK_ROOT", "-v", "/path/to/memory-bank:/mnt/memory_bank", "memory-bank-mcp:local" ], "env": { "MEMORY_BANK_ROOT": "/mnt/memory_bank" }, "disabled": false, "alwaysAllow": [ "list_projects", "list_project_files", "memory_bank_read", "memory_bank_update", "memory_bank_write" ] }

기여하다

여러분의 참여를 환영합니다! 다음 단계를 따라주세요.

1. 저장소를 포크하세요
2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
3. 변경 사항을 커밋하세요( git commit -m 'Add amazing feature' )
4. 브랜치에 푸시( git push origin feature/amazing-feature )
5. 풀 리퀘스트 열기

개발 지침

• 모든 새 코드에 TypeScript를 사용하세요
• 코드베이스 전체에서 유형 안전성 유지
• 새로운 기능에 대한 테스트 추가
• 필요에 따라 문서를 업데이트하세요
• 기존 코드 스타일과 패턴을 따르세요

테스트

• 새로운 기능에 대한 단위 테스트를 작성하세요
• 다중 프로젝트 시나리오 테스트 포함
• 오류 사례를 철저히 테스트하세요
• 유형 제약 조건 검증
• 파일 시스템 작업을 적절하게 모의합니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

감사의 말

이 프로젝트는 Cline Memory Bank 에 원래 문서화된 메모리 뱅크 개념을 구현하고, 원격 기능과 다중 프로젝트 지원을 확장합니다.