메모리 시스템 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