메모리 시스템 API
MCP 도구Diverga 메모리 시스템을 구동하는 Model Context Protocol (MCP) 도구의 완전한 레퍼런스.
메모리 섹션
Priority Context
세션 시작 시 항상 로드 (최대 500자)
Working Memory
타임스탬프 엔트리, 7일 후 자동 삭제
Manual Section
자동 삭제 안 됨, 영구 노트
Notepad 도구
세션 메모리 위치: {worktree}/.omc/notepad.md
notepad_read
notepad 읽기
매개변수
section'all' | 'priority' | 'working' | 'manual'optional읽을 섹션 (기본: all)
workingDirectorystringoptional작업 디렉토리
반환값
Notepad 내용 (선택한 섹션)
예제
notepad_read({ section: "priority" })notepad_write_priority
Priority Context 설정 (기존 내용 대체)
매개변수
contentstringrequired쓸 내용 (500자 이하 권장)
workingDirectorystringoptional작업 디렉토리
반환값
성공 메시지
예제
notepad_write_priority({
content: "Research question: How does AI improve learning?"
})notepad_write_working
Working Memory에 엔트리 추가 (타임스탬프 자동)
매개변수
contentstringrequired추가할 내용
workingDirectorystringoptional작업 디렉토리
반환값
성공 메시지
예제
notepad_write_working({
content: "Decided to use Two-Stage MASEM for mediation analysis"
})notepad_write_manual
MANUAL 섹션에 엔트리 추가 (영구 보관)
매개변수
contentstringrequired추가할 내용
workingDirectorystringoptional작업 디렉토리
반환값
성공 메시지
예제
notepad_write_manual({
content: "Always use Hedges' g for meta-analysis effect sizes"
})notepad_prune
오래된 Working Memory 엔트리 제거
매개변수
daysOldnumberoptional삭제할 날짜 임계값 (기본: 7)
workingDirectorystringoptional작업 디렉토리
반환값
삭제된 엔트리 수
예제
notepad_prune({ daysOld: 14 })notepad_stats
Notepad 통계 조회
매개변수
workingDirectorystringoptional작업 디렉토리
반환값
크기, 엔트리 수, 가장 오래된 엔트리
예제
notepad_stats()
프로젝트 메모리 도구
영구 프로젝트 정보: {worktree}/.omc/project-memory.json
project_memory_read
프로젝트 메모리 읽기
매개변수
section'all' | 'techStack' | 'build' | 'conventions' | 'structure' | 'notes' | 'directives'optional읽을 섹션 (기본: all)
workingDirectorystringoptional작업 디렉토리
반환값
프로젝트 메모리 내용
예제
project_memory_read({ section: "techStack" })project_memory_write
프로젝트 메모리 쓰기/업데이트 (병합 지원)
매개변수
memoryRecord<string, any>required쓸 메모리 객체
mergebooleanoptional기존 메모리와 병합 여부 (기본: false)
workingDirectorystringoptional작업 디렉토리
반환값
성공 메시지
예제
project_memory_write({
memory: {
techStack: ["Python", "LangChain", "Qdrant"],
build: "pip install -r requirements.txt"
},
merge: true
})project_memory_add_note
카테고리별 노트 추가
매개변수
categorystringrequired노트 카테고리 (예: "build", "test", "deploy")
contentstringrequired노트 내용
workingDirectorystringoptional작업 디렉토리
반환값
성공 메시지
예제
project_memory_add_note({
category: "analysis",
content: "Use MASEM for mediation meta-analysis"
})project_memory_add_directive
영구 사용자 지침 추가 (압축 방지)
매개변수
directivestringrequired지침 내용
contextstringoptional지침 맥락
priority'high' | 'normal'optional우선순위 (기본: normal)
workingDirectorystringoptional작업 디렉토리
반환값
성공 메시지
예제
project_memory_add_directive({
directive: "Always use TypeScript strict mode",
priority: "high"
})상태 관리 도구
상태 저장 위치: {worktree}/.omc/state/{mode}-state.json
state_read
특정 모드의 상태 읽기
매개변수
mode'autopilot' | 'ultrapilot' | 'swarm' | 'pipeline' | 'ralph' | 'ultrawork' | 'ultraqa' | 'ecomode' | 'ralplan'required읽을 모드
workingDirectorystringoptional작업 디렉토리
반환값
상태 JSON 데이터 또는 없음
예제
state_read({ mode: "autopilot" })state_write
특정 모드의 상태 쓰기 (주의해서 사용)
매개변수
mode'autopilot' | 'ultrapilot' | 'swarm' | 'pipeline' | 'ralph' | 'ultrawork' | 'ultraqa' | 'ecomode' | 'ralplan'required쓸 모드
activebooleanoptional모드 활성 상태
iterationnumberoptional현재 반복 횟수
max_iterationsnumberoptional최대 반복 횟수
current_phasestringoptional현재 단계
stateRecord<string, any>optional추가 커스텀 필드
workingDirectorystringoptional작업 디렉토리
반환값
성공 메시지
예제
state_write({
mode: "autopilot",
active: true,
iteration: 3,
current_phase: "implementation"
})state_clear
특정 모드의 상태 삭제
매개변수
mode'autopilot' | 'ultrapilot' | 'swarm' | 'pipeline' | 'ralph' | 'ultrawork' | 'ultraqa' | 'ecomode' | 'ralplan'required삭제할 모드
workingDirectorystringoptional작업 디렉토리
반환값
성공 메시지
예제
state_clear({ mode: "autopilot" })state_list_active
현재 활성 모드 나열
매개변수
workingDirectorystringoptional작업 디렉토리
반환값
활성 상태 파일이 있는 모드 배열
예제
state_list_active()
state_get_status
특정 모드 또는 모든 모드의 상세 상태
매개변수
mode'autopilot' | 'ultrapilot' | 'swarm' | 'pipeline' | 'ralph' | 'ultrawork' | 'ultraqa' | 'ecomode' | 'ralplan'optional상태 조회할 모드 (생략 시 전체)
workingDirectorystringoptional작업 디렉토리
반환값
활성 상태, 파일 경로, 상태 내용
예제
state_get_status({ mode: "ralph" })지원 모드
autopilotultrapilotswarmpipelineralphultraworkultraqaecomoderalplan