cd C:\Users\admin\Documents\ClaudeMCP
npm install
npm run build

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": [
        "C:\\Users\\admin\\Documents\\ClaudeMCP\\build\\index.js"
      ]
    }
  }
}

{
  category: string;    // 예: "UE5_Rendering", "PCG", "ProjectGray"
  title: string;       // 짧은 제목
  content: string;     // 전체 내용 (최대 1MB)
  tags?: string[];     // 선택적 태그 (자동 정규화)
}

{
  id: string;  // 메모리 ID
}

{
  id: string;
  title?: string;      // 선택적
  content?: string;    // 선택적 (최대 1MB)
  tags?: string[];     // 선택적 (자동 정규화)
}

{
  query?: string;      // 텍스트 검색
  category?: string;   // 카테고리 필터
  tags?: string[];     // 태그 필터 (대소문자 무시)
  limit?: number;      // 결과 개수 제한
}

{
  ids: string[];  // 병합할 메모리 ID 배열 (최소 2개)
}

{
  id: string;
}

C:\Users\admin\Documents\ClaudeMCP\memories\backups\backup_{timestamp}\

{
  timestamp: string;  // 백업 타임스탬프
}

{
  category?: string;    // 선택적 (특정 카테고리만)
  output_path: string;  // 저장 경로
}

{
  category: "UE5_Rendering",
  output_path: "C:\\backup\\ue5_memories.json"
}

{
  input_path: string;   // 파일 경로
  overwrite?: boolean;  // 기존 메모리 덮어쓰기 (기본: false)
}

User: "RDG에서 FRDGBuilder 사용법 기억해줘. 
       FRDGBuilder로 리소스 생성하고, AddPass로 패스 추가하고..."

Claude: [save_memory 내부 호출]
{
  category: "UE5_Rendering",
  title: "RDG FRDGBuilder 사용법",
  content: "...",
  tags: ["rdg", "frdgbuilder", "rendering"]  // 자동 정규화
}
→ "✅ Memory saved! ID: mem_xxx..."

User: "RDG + SceneViewExtension 작업 시작할건데, 관련 기억 불러와"

Claude: [search_memory 내부 호출]
{
  query: "RDG SceneViewExtension",
  category: "UE5_Rendering"
}
→ 검색 결과 3개:
   1. RDG Best Practices
   2. SceneViewExtension 구조
   3. RDG Pass 추가 방법

User: "ColorCorrectRegions처럼 PostProcess 구현하고 싶어"

Claude: [자동으로 search_memory 호출]
→ "ColorCorrectRegions 분석" 메모리 로드
→ 저장된 아키텍처 기반으로 구체적 답변

User: "RDG 관련 메모리가 여러 개인데 하나로 합쳐줘"

Claude: [search_memory로 찾고 merge_memories 호출]
{
  ids: ["mem_123", "mem_456", "mem_789"]
}
→ 하나의 통합된 메모리 생성

User: "메모리 백업하고 다른 컴퓨터로 옮기고 싶어"

Claude: 
1. [export_memories 호출]
   → ue5_memories.json 파일 생성
2. 파일을 USB나 클라우드로 복사
3. 다른 컴퓨터에서 [import_memories 호출]

User: "검색이 이상해, 메모리는 있는데 안 나와"

Claude: [rebuild_index 호출]
→ "✅ Index rebuilt! 50 memories indexed"

ClaudeMCP/
├── memories/
│   ├── index.json                    # 검색용 인덱스 (메타데이터)
│   │
│   ├── UE5_Rendering/               # 카테고리별 폴더
│   │   ├── mem_xxx.json             # 메모리 본체
│   │   ├── mem_xxx_v1.json          # 버전 1 백업
│   │   ├── mem_xxx_v2.json          # 버전 2 백업
│   │   └── mem_yyy.json
│   │
│   ├── PCG/
│   │   ├── mem_zzz.json
│   │   └── mem_zzz_v1.json
│   │
│   └── backups/                      # 전체 백업
│       ├── backup_2025-01-08T10-30-00-000Z/
│       │   ├── metadata.json
│       │   ├── index.json
│       │   ├── UE5_Rendering/
│       │   └── PCG/
│       └── backup_2025-01-09T15-20-00-000Z/
│
└── src/
    ├── index.ts                      # 메인 서버 (1200+ lines)
    └── types.ts                      # TypeScript 타입 정의

const CONFIG = {
  DATA_DIR: path.join(__dirname, "..", "memories"),
  MAX_VERSIONS: 5,           // 버전 백업 최대 개수
  MAX_CONTENT_SIZE: 1048576, // 1MB per memory
};

# TypeScript 컴파일 (watch mode)
npm run watch

# 빌드
npm run build

# 로그 확인 (stderr로 출력)
# Claude Desktop의 로그 파일 확인

[2025-01-08T10:30:00.000Z] [INFO] Memory saved: mem_xxx (UE5_Rendering/RDG Best Practices)
[2025-01-08T10:35:00.000Z] [WARN] Failed to read memory file: corrupted.json
[2025-01-08T10:40:00.000Z] [ERROR] Failed to save memory

["RDG", "rdg", " RDG "] → ["rdg"]  // 자동 정규화

→ rebuild_index 실행

→ list_backups 확인
→ restore_backup 실행

자동으로 정규화되므로 문제 없음
["RDG", "rdg"] → ["rdg"]

자동으로 5개만 유지됨 (MAX_VERSIONS 설정)