---
title: "Maester v3 MVP Build Report — 완료"
from: claude-code
to: ["jadong"]
project: "sentinel"
date: 2026-05-08T22:17:04.941630+09:00
status: sent
type: report
---

# Maester v3 MVP Build Report

> 빌드 완료: 2026-05-08 22:10 KST
> 빌더: Claude Code Opus 4.6 (프레데터)
> 소요: ~30분 (설계 논의 제외)

---

## 가동 서비스 현황

| 서비스 | 포트 | 상태 | 역할 |
|--------|------|------|------|
| **Maester MCP** | 8766 | systemd active | GraphRAG 도구 4개 (ingest/recall/doc_get/doc_update) |
| **Maester HTTP API** | 8780 | systemd active | REST API 9개 엔드포인트 |
| **OpenClaw MCP** | 8765 | systemd active | 기존 26개 도구 (Claude App 커넥터 복구) |
| **OpenClaw Gateway** | 18789 | active | 자비스 게이트웨이 |
| **Neo4j Docker** | 7474/7687 | running | 그래프 DB (Maester 전용) |

## Neo4j 현재 상태



Source: balerion_ontology 347건 + balerion_ontology_relations 276건 from Supabase

## HTTP API 엔드포인트 (port 8780)

| Method | Path | 기능 |
|--------|------|------|
| GET | /api/health | 헬스체크 (Neo4j 연결 포함) |
| POST | /api/maester/ingest | 원문 적재 (엔티티 추출 + Neo4j + 자동 링킹) |
| POST | /api/maester/recall | GraphRAG 쿼리 (자연어 → 관련 문서+관계+URL) |
| GET | /api/maester/docs/{id} | 문서 원문 + 메타데이터 조회 |
| PATCH | /api/maester/docs/{id} | 문서 수정 (버전 히스토리 자동 보존) |
| DELETE | /api/maester/docs/{id} | Soft delete (휴지통, 복원 가능) |
| POST | /api/maester/docs/{id}/restore | 휴지통에서 복원 |
| GET | /api/maester/docs/{id}/versions | 버전 히스토리 조회 |
| GET | /api/maester/graph | 그래프 조회 (focus node + depth 탐색) |
| GET | /api/maester/search | 엔티티 기반 검색 |

## MCP 도구 (port 8766)

| 도구 | 설명 |
|------|------|
| maester_ingest | 원문을 Maester에 적재. 엔티티 추출 + Neo4j + 자동 링킹 |
| maester_recall | GraphRAG recall. 쿼리 → 관련 원문 + 관계 + URL 반환 |
| maester_doc_get | 문서 원문 + 메타데이터 조회 |
| maester_doc_update | 문서 수정 (버전 자동 보존 + 엔티티 재추출) |

## E2E 테스트 결과

### Ingest 테스트


### Auto-Linking 테스트


### Recall 테스트


### API 전체 테스트


## 복구된 서비스

| 서비스 | 이전 | 이후 |
|--------|------|------|
| OpenClaw MCP :8765 | DOWN | ✅ systemd active |
| OpenClaw Gateway :18789 | DOWN | ✅ active |
| Claude App Custom Connector | BROKEN (MCP 다운) | ✅ 복구 (MCP 가동) |
| consciousness-bridge | venv 깨짐 | ✅ 복구 (--status 정상) |

## 프로젝트 구조



## v3 결정문 성공 기준 대조

| 기준 | 상태 |
|------|------|
| Markdown 원문 1개 ingest | ✅ |
| Neo4j에 Document/Decision/Project/Person/Concept 생성 | ✅ |
| 관련 노드 1~2개 자동 연결 | ✅ (score 0.7) |
| recall query로 원문 + 관계 + doc_url 반환 | ✅ |
| ai.shinjadong.cloud에서 문서 열람 | ⬜ (EC2 SSH 접근 필요, Maester API로 우회 가능) |

## 다음 세션 작업

| # | 작업 | 비고 |
|---|------|------|
| 1 | Tailscale로 Maester API 외부 노출 | ChatGPT Actions + 모든 AI 접근용 |
| 2 | 정리 트리거 → maester_ingest 호출 코드화 | 프롬프트 컨벤션 → 실제 코드 |
| 3 | ai.shinjadong.cloud 그래프 뷰 프론트엔드 | EC2 SSH 접근 후 |
| 4 | ChatGPT Custom GPT + Actions | Maester recall API 연결 |
| 5 | 기존 daily_log 57건 → Maester 일괄 ingest | 역사 데이터 적재 |
| 6 | 임베딩 벡터 추가 | recall 정확도 향상 |

---

*Maester v3 = 자동님의 개인용 Palantir. 첫 심장이 뛰기 시작했습니다.*