Roo 코드 메모리 뱅크 MCP 서버

이 프로젝트는 Roo 코드 메모리 뱅크 시스템의 핵심 기능을 모델 컨텍스트 프로토콜(MCP) 서버로 구현합니다. 이를 통해 AI 어시스턴트는 구조화된 MCP 도구를 사용하여 파일 기반 메모리 뱅크와 상호 작용함으로써 세션 전반에 걸쳐 프로젝트 컨텍스트를 유지할 수 있습니다.

특징

이 MCP 서버는 다음과 같은 도구를 제공합니다.

initialize_memory_bank : 초기 템플릿을 사용하여 memory-bank/ 디렉토리와 표준 .md 파일( productContext.md , activeContext.md , progress.md , decisionLog.md , systemPatterns.md )을 생성합니다.
- 입력 : (선택 사항) { "project_brief_content": string }
- 출력 : { "status": "success" | "error", "messages"?: string[], "message"?: string }
check_memory_bank_status : memory-bank/ 디렉토리가 존재하는지 확인하고 그 안에 있는 .md 파일을 나열합니다.
- 입력 : {}
- 출력 : { "exists": boolean, "files": string[] }
read_memory_bank_file : 지정된 메모리 뱅크 파일의 전체 내용을 읽습니다.
- 입력 : { "file_name": string }
- 출력 : { "content": string } 또는 오류 객체.
append_memory_bank_entry : 지정된 파일에 타임스탬프가 있는 새 항목을 추가합니다. 선택적으로 특정 마크다운 헤더 아래에 추가할 수 있습니다. 파일이 없으면 새로 생성합니다.
- 입력 : { "file_name": string, "entry": string, "section_header"?: string }
- 출력 : { "status": "success" | "error", "message": string }

필수 조건

Node.js(v18 이상 권장)
npm(일반적으로 Node.js에 포함됨)
MCP 서버를 관리하고 실행할 수 있는 MCP 클라이언트 환경(클라인이 사용하는 환경과 유사)

설치

저장소를 복제합니다.지엑스피1
종속성 설치:
npm install
프로젝트를 빌드하세요:
npm run build
이렇게 하면 TypeScript 코드가 dist/ 디렉토리의 JavaScript로 컴파일됩니다.

구성(Cline MCP 클라이언트용)

이 서버를 AI 비서(예: Cline)가 사용할 수 있게 하려면 해당 구성을 MCP 설정 파일(예: cline_mcp_settings.json )에 추가해야 합니다.

설정 파일에서 mcpServers 객체를 찾아 다음 항목을 추가하세요.

{
  "mcpServers": {
    // ... other server configurations ...

    "roo-code-memory-bank-mcp": {
      "autoApprove": [
        "initialize_memory_bank",
        "check_memory_bank_status",
        "read_memory_bank_file",
        "append_memory_bank_entry"
      ],
      "disabled": false,
      "timeout": 60,
      "command": "node", // Or "cmd.exe" with "/c node ..." on Windows if needed
      "args": [
        // IMPORTANT: Replace this path with the actual absolute path
        // to the compiled index.js file on your system
        "/path/to/your/cloned/repo/roo-code-memory-bank-mcp-server/dist/index.js"
      ],
      "env": {},
      "transportType": "stdio"
    }

    // ... other server configurations ...
  }
}

중요: /path/to/your/cloned/repo/ 컴퓨터에서 저장소를 복제한 경로의 올바른 절대 경로로 바꾸세요. 경로 구분 기호가 운영 체제에 맞는지 확인하세요(예: Windows에서는 백슬래시 \ 사용).

서버 실행

일반적으로 서버를 수동으로 실행할 필요는 없습니다. MCP 클라이언트(Cline 등)는 해당 도구 중 하나를 처음 호출할 때 구성 파일에 지정된 command 과 args 사용하여 서버를 자동으로 시작합니다.

수동으로 테스트하려면 프로젝트 디렉토리에서 npm start 실행하면 됩니다.

용법

AI 비서는 정의된 도구를 사용하여 서버와 상호 작용합니다. 일반적인 워크플로는 다음과 같습니다.

메모리 뱅크 상태 확인( check_memory_bank_status ).
필요한 경우 초기화합니다( initialize_memory_bank ).
관련 파일을 읽어서( read_memory_bank_file ) 컨텍스트를 파악합니다.
결정이 내려지거나 진행이 진행됨에 따라 항목을 추가합니다( append_memory_bank_entry ).

memory-bank/ 디렉토리는 서버 프로세스가 시작되는 디렉토리와 동일한 디렉토리에 생성됩니다(MCP 클라이언트 구성을 통해 시작할 경우 이 프로젝트 디렉토리의 루트여야 함).

사용자 정의 지침

이 지침을 Roo 내부에 설정하세요

필요한 경우 MCP를 사용해야 합니다.

특정 MCP 흐름이 있습니다.

context7을 사용하여 이 프로세스에 필요한 관련 문서를 찾고, 관련 지식을 관련 하위 작업에 제공해야 합니다. 무언가 불확실한 경우 항상 context7을 사용하여 중요한 문서를 조사하세요. Google Maps MCP를 사용하여 + -를 검색하세요. 이렇게 하면 작업을 수행하는 데 필요한 기본적인 업체를 찾을 수 있습니다. Brave Search MCP를 사용하여 스크래핑할 URL을 찾으세요. fetch_txt 및 fetch_markdown과 함께 fetch MCP를 사용하여 페이지에서 텍스트와 이미지를 찾아 JSON 파일로 변환하고 심층적인 내용을 만드세요. Openrouter 검색을 사용하여 주제, 리뷰 등에 대한 일반적인 감정을 찾으세요.

프로젝트 컨텍스트를 유지하려면 roo-code-memory-bank-mcp 서버를 활용하세요.

작업이나 중요한 하위 작업을 시작할 때 check_memory_bank_status 사용합니다.
메모리 뱅크가 존재하는 경우( exists: true ), 관련 파일(예: productContext.md , activeContext.md )에 대해 read_memory_bank_file 사용하여 현재 프로젝트 컨텍스트를 로드합니다.
이러한 맥락을 계획과 실행에 통합하세요.
중요한 결정, 진행 상황 업데이트 또는 아키텍처 변경을 할 때 append_memory_bank_entry 사용하여 해당 파일( decisionLog.md , progress.md 등)에 정보를 기록하여 컨텍스트 지속성을 보장합니다.
메모리 뱅크가 존재하지 않는 경우 프로젝트에 적합하다면 initialize_memory_bank 사용하는 것을 고려하세요.

Roo Code Memory Bank MCP Server

Integrations