모공에 올렸던 작업기억MCP 서버를 공개합니다.
(기존보다 도구 개수를 줄이고 버그 수정 등등)

AI를 통해 만들었습니다.

사용자 설정은 적절하게 수정하시면 됩니다.

다운로드 링크 :  moontmsai/work-memory-mcp: Never lose context again - persistent memory management system for AI-powered workflows across multiple tools 

Work Memory MCP Server (한글)

업무 작업 기억을 관리하고 AI 도구 간에 컨텍스트를 공유하기 위한 통합 MCP (Model Context Protocol) 서버입니다.

프로젝트 목적

Work Memory MCP는 개발자와 지식 작업자가 여러 AI 도구(Claude, Cursor AI 등)를 사용하면서 일관된 작업 컨텍스트를 유지할 수 있도록 도와주는 메모리 관리 시스템입니다. 각각의 AI 대화 세션에서 축적된 지식과 작업 진행 상황을 체계적으로 관리하여, 연속적이고 효율적인 작업 환경을 제공합니다.

핵심 가치

지속성 (Persistence)

AI와의 대화는 세션이 끝나면 사라지지만, 중요한 작업 내용과 결과물은 영구적으로 보존되어야 합니다. Work Memory MCP는 모든 중요한 작업 기억을 SQLite 데이터베이스에 안전하게 저장하여 언제든지 접근할 수 있도록 합니다.

일관성 (Consistency)

여러 AI 도구를 사용하더라도 동일한 작업 컨텍스트를 공유할 수 있습니다. Claude Desktop에서 시작한 작업을 Cursor AI에서 이어받거나, 다른 도구에서 참조할 수 있는 일관된 작업 환경을 제공합니다.

효율성 (Efficiency)

이미 해결한 문제나 정리한 정보를 반복적으로 설명할 필요가 없습니다. 고급 검색 시스템을 통해 과거의 작업 내용을 빠르게 찾아 재활용할 수 있어, 작업 효율성이 크게 향상됩니다.

구조화 (Organization)

무작위로 흩어진 정보가 아닌, 프로젝트별, 중요도별, 태그별로 체계적으로 정리된 지식 베이스를 구축할 수 있습니다. 세션 기반 관리를 통해 각 프로젝트의 컨텍스트를 명확하게 분리하여 관리합니다.

주요 기능

메모리 관리

• 작업 내용, 결과물, 학습한 내용을 구조화된 형태로 저장
• 중요도 점수(0-100점)를 통한 우선순위 관리
• 태그 시스템으로 다차원적 분류
• 할일(Todo)과 일반 메모리(Memory) 구분 관리
• 완료 상태 추적을 통한 작업 진행률 관리

세션 관리

• 프로젝트별 독립적인 작업 세션 생성
• 세션 컨텍스트 자동 감지 및 연결
• 세션별 작업 기억 연동 및 추적
• 세션 생명주기 관리 (생성, 활성화, 종료)

고급 검색

• 키워드 기반 전문 검색
• 프로젝트, 중요도, 세션별 필터링
• 연관 키워드 추천 시스템
• 검색 결과 하이라이트 및 컨텍스트 제공
• 검색 성능 최적화 및 통계 제공

이력 관리

• 모든 작업 기억 변경 이력 추적
• 버전 관리 시스템을 통한 이전 상태 복원
• 변경 사항 비교 및 분석
• 자동 백업 및 복구 기능

시스템 최적화

• 데이터베이스 성능 모니터링
• 자동 인덱스 관리 및 최적화
• 메모리 사용량 추적
• 일괄 작업 처리 시스템
• 안전한 데이터 정리 기능

통합 도구 구성

Work Memory MCP는 5개의 통합 도구로 구성되어 있습니다:

1. Memory (메모리 관리)

작업 기억의 생성, 수정, 조회, 삭제를 담당하는 핵심 도구입니다.

주요 기능:

• add: 새로운 작업 기억 추가
• update: 기존 작업 기억 수정
• list: 작업 기억 목록 조회 (필터링 및 페이징 지원)
• delete: 작업 기억 삭제 또는 아카이브

지원하는 데이터 유형:

• 일반 메모리: 학습 내용, 아이디어, 참고 자료
• 할일: 수행해야 할 작업과 진행 상태
• 프로젝트별 분류
• 태그 기반 다차원 분류
• 중요도 점수 (0-100점)

2. Search (검색 및 분석)

저장된 작업 기억을 효율적으로 찾고 분석하는 도구입니다.

주요 기능:

• search: 키워드 기반 검색
• keywords: 연관 키워드 분석
• stats: 검색 시스템 통계
• optimize: 검색 인덱스 최적화

검색 기능:

• 전문 텍스트 검색
• 다중 조건 필터링
• 중요도별 정렬
• 검색 결과 하이라이트
• 연관 키워드 추천
• 검색 성능 통계

3. Session (세션 관리)

프로젝트별 작업 세션을 관리하는 도구입니다.

주요 기능:

• create: 새 세션 생성
• activate: 세션 활성화
• deactivate: 세션 비활성화
• list: 세션 목록 조회
• status: 현재 세션 상태 확인
• detect: 자동 세션 감지

세션 관리 특징:

• 프로젝트별 독립적인 작업 공간
• 자동 세션 감지 및 연결
• 세션별 작업 기억 연동
• 독점 세션 모드 (30분 동안 유지)
• 세션 통계 및 활동 추적

4. History (이력 관리)

작업 기억의 변경 이력과 버전을 관리하는 도구입니다.

주요 기능:

• changes: 변경 이력 조회
• versions: 버전 목록 조회
• restore: 이전 버전 복원
• list_versions: 전체 버전 이력

버전 관리 특징:

• 자동 버전 생성
• 변경 사항 상세 추적
• 버전 간 비교 기능
• 선택적 복원 기능
• 버전 정리 및 최적화

5. System (시스템 관리)

서버 상태 모니터링과 시스템 최적화를 담당하는 도구입니다.

주요 기능:

• status: 서버 상태 조회
• monitor: 실시간 모니터링
• optimize: 데이터베이스 최적화
• batch: 일괄 작업 처리
• delete: 카테고리별 데이터 정리
• diagnose: 시스템 진단
• analyze: 상세 분석
• repair: 자동 복구

시스템 관리 특징:

• 실시간 성능 모니터링
• 자동 인덱스 관리
• 메모리 사용량 추적
• 데이터베이스 최적화
• 안전한 데이터 정리
• 시스템 건강 상태 진단

설치 방법

1. 시스템 요구사항

• Node.js 18.0.0 이상
• npm 8.0.0 이상
• 운영체제: Windows, macOS, Linux

2. 프로젝트 클론 및 설치

git clone https://github.com/your-repo/work-memory-mcp.git

cd work-memory-mcp

npm install

3. 프로젝트 빌드

npm run build

4. 서버 테스트 실행

npm start

설정 방법

Claude Desktop 설정 (또는 cursor.ai)

Claude Desktop에서 Work Memory MCP를 사용하려면 설정 파일에 다음을 추가해야 합니다.

Windows 설정 파일 위치:

%APPDATA%\Claude\claude_desktop_config.json


macOS 설정 파일 위치:

~/Library/Application Support/Claude/claude_desktop_config.json


설정 파일 내용:

{

"mcpServers": {

"work-memory": {

"command": "node",

"args": ["/PATH/work-memory/dist/index.js"],

"env": {

"WORK_MEMORY_DIR": "/PATH/work-memory/data/",

"LOG_LEVEL": "WARN",

"NODE_ENV": "production"

      }

    }

  }

}

환경 변수 설정 (선택사항)

다음 환경 변수들을 설정할 수 있습니다:

# 로그 레벨 설정 (기본값: INFO)

LOG_LEVEL=WARN

# 데이터베이스 저장 디렉토리 (기본값: ./work_memory)

WORK_MEMORY_DIR=/PATH/work-memory/data/

# 데이터베이스 파일명 (WORK_MEMORY_DIR 설정시에만 적용, 기본값: database.sqlite)

DB_FILENAME=database.sqlite

참고:

• WORK_MEMORY_DIR이 설정되지 않으면 DB_FILENAME은 무시되고 'database.sqlite'로 고정됩니다.
• 캐시 메모리 사용량(50MB)은 현재 코드에서 하드코딩되어 있으며, 환경 변수로 설정할 수 없습니다.

Cursor AI 설정

Cursor AI에서 사용하려면 MCP 확장이나 플러그인을 통해 연결할 수 있습니다. 자세한 설정 방법은 Cursor AI의 MCP 지원 문서를 참조하세요.

권장 사용자 설정

Work Memory MCP를 최적으로 활용하기 위해 AI 어시스턴트의 사용자 설정에 다음 내용을 추가하세요:

# [세션 시작 시 1회만 실행]
 0. 세션이 처음 시작될 때만 다음을 실행하세요:
    - "기억을 찾아보는 중..." 이라고 말합니다.
    - work-memory mcp에서 최신 작업기억 3개 조회합니다.
    - 중요도 높은 미완료 할일 3개 조회합니다.
    - 조회한 작업기억과 할일은 사용자에게 브리핑합니다.

 # [스마트 세션 관리]
 1. 대화 내용이 특정 프로젝트, 주제영역, 또는 지속적 작업에 해당한다고 판단될 때, 관련 세션을 자동으로 감지하고 활성화한다.
    - 단순 질답이 아닌 연속적 작업으로 판단 시 session_status detect_active 실행
    - 관련 세션 있으면 자동 활성화, 없으면 새 세션 준비
    - 한번 활성화된 세션은 30분 동안 독점 유지 (활동 시 연장)
    - 다른 주제영역 전환 시에만 세션 교체
    - 모든 관련 작업이 자동으로 같은 세션에 연결
    - 세션에 대해 간단히 브리핑

 # [일반 대화 중 반복적으로 수행]
 2. 대화가 진행되는 동안에는 다음 원칙만 따릅니다:
    - 모든 응답은 중요도를 판단하여(100점 만점), 50점 이상일 경우 work-memory mcp에 저장합니다.
    - 기존 기억을 기반으로만 판단하고 반복 조회하지 않습니다.