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. 첫 심장이 뛰기 시작했습니다.