mcp-agents-memory 0.8.0 → 0.8.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-agents-memory",
-  "version": "0.8.0",
+  "version": "0.8.3",
   "description": "Long-term memory for AI agents with provenance tracking",
   "main": "build/index.js",
   "type": "module",
@@ -11,7 +11,7 @@
     "build",
     ".env.example",
     "README.md",
-    "README_KR.md",
+    "RESPEC.md",
     "LICENSE"
   ],
   "scripts": {
@@ -20,7 +20,8 @@
     "start": "node build/index.js",
     "dev": "ts-node --esm src/index.ts",
     "setup": "npm run build && node build/index.js setup",
-    "migrate": "npm run build && node build/index.js migrate"
+    "migrate": "npm run build && node build/index.js migrate",
+    "bench:tagger": "npx tsx scripts/ab_tagger.ts"
   },
   "keywords": [
     "mcp",

package/README_KR.md

@@ -1,113 +0,0 @@
-# mcp-agents-memory (v0.6.0)
-
-멀티 에이전트 공유 장기 기억 MCP 서버.  
-AI 에이전트(Claude, Gemini, GPT 등)가 별도의 설정 없이도 **자율적으로 기억을 관리**하고, 지능적인 검증을 통해 신뢰할 수 있는 지식 베이스를 구축하게 해주는 MCP 서버입니다.
-
-## 🌟 v0.6 신규 기능: 유니버설 자율성 (Universal Autonomy)
-
-- **🧠 Zero-Config 자율성**: 더 이상 `settings.json`에 복잡한 hooks를 설정할 필요가 없습니다! 서버가 MCP `instructions` 필드를 통해 에이전트에게 직접 지침을 내려, 에이전트가 스스로 메모리 도구를 사용하도록 유도합니다.
-- **⚖️ 선별적 감사 (Selective Audit)**: 추출된 모든 사실 중 중요도가 높은 상위 5개의 사실만 골라 고성능 모델(Opus/Grok)에게 정밀 검증을 맡깁니다. 비용은 아끼고 품질은 높였습니다.
-- **🌐 출처 가중치 (Source Weighting)**: 외부 사실 검증 시 도메인 권위(.gov, .edu, 공식 문서 등)에 따라 가중치를 부여합니다. 공신력 있는 정보를 우선적으로 신뢰합니다.
-- **⚡ MCP Prompts (슬래시 명령어)**: `/briefing`, `/recall <query>`, `/save <text>`와 같은 직관적인 명령어로 메모리와 직접 상호작용할 수 있습니다.
-- **🔐 통합 출처 관리**: 모든 기억에 출처 모델(`author_model`), 플랫폼(`platform`), 세션 ID가 자동으로 기록되어 완벽한 추적성을 보장합니다.
-
-## 주요 기능
-
-- **📚 Librarian AI**: 대화 원문을 자동으로 분석 → 핵심 사실(fact) 추출, 분류, 저장
-- **⚡ 모순 해결(Contradiction Resolution)**: "서울 거주" → "부산 이사" 같은 모순을 자동 감지하고 기존 기억을 업데이트(Supersede)합니다.
-- **🧠 스마트 브리핑**: 세션 시작 시 유저 프로필, 프로젝트 상태, 핵심 결정사항을 한 번에 브리핑합니다.
-- **🔍 시맨틱 검색**: 벡터 임베딩 기반 검색 + 유저 프로필 자동 첨부 기능을 지원합니다.
-- **🔐 SSH 터널링**: 원격 DB에 안전하게 접속하며, 안정적인 연결 관리 기능을 제공합니다.
-- **🤖 멀티 에이전트**: 어떤 AI 모델이나 플랫폼을 사용하더라도 동일한 메모리 풀을 공유합니다.
-
-## 🧠 하이브리드 지능 기술 스택 (Hybrid Intelligence)
-
-v0.6은 대량의 데이터 처리는 효율적인 모델이, 핵심적인 추론과 검증은 최고급 모델이 담당하는 **지능형 멀티 모델 아키텍처**를 채택하고 있습니다.
-
-| 역할 | 기술 | 설명 |
-|----------|------------|-------------|
-| **메인 브레인** | Anthropic `Claude 3 Opus` | **선별적 감사(Selective Audit)**: 고가치 사실 및 결정 사항 정밀 검증. |
-| **진실 추론기** | xAI `Grok-1` | **검증 통합(Validation Synthesis)**: 외부 웹 데이터를 기반으로 사실성 판단. |
-| **사실 추출기** | OpenAI `gpt-4o-mini` | **Librarian 엔진**: 빠르고 비용 효율적인 데이터 추출 및 분류. |
-| **임베딩** | OpenAI `text-embedding-3-small` | **시맨틱 검색**: 표준화된 1536차원 벡터 인덱싱. |
-| **검색 엔진** | Tavily + Exa | **가중치 기반 검색**: 도메인 권위(gov, edu)를 고려한 외부 근거 확보. |
-| **데이터베이스** | PostgreSQL + pgvector | **벡터 저장소**: 확장 가능한 장기 기억 저장소. |
-
-## 설치 및 설정
-
-### 1. 설치 및 빌드
-
-```bash
-npm install
-npm run build
-```
-
-### 2. 설정 위저드 실행
-
-```bash
-npm run setup
-```
-
-DB 연결, SSH 터널, OpenAI API 키를 설정하고 스키마를 자동 생성합니다.
-
-### 3. 모든 MCP 클라이언트에 연결
-클라이언트(Claude Code, Antigravity 등)에 서버를 추가하기만 하면 됩니다. 별도의 훅 설정은 필요하지 않습니다!
-```bash
-claude mcp add mcp-agents-memory node /path/to/build/index.js
-```
-
-## 도구 및 프롬프트 (v0.6)
-
-### 🚨 Prompts (슬래시 명령어)
-- `/briefing`: 현재 세션의 전체 브리핑을 요청합니다.
-- `/recall <query>`: 메모리에서 관련 정보를 빠르게 검색합니다.
-- `/save <text>`: 특정 사실이나 결정사항을 수동으로 저장합니다.
-
-### 🛠️ 핵심 도구
-- `memory_startup`: 유저 프로필 및 프로젝트 상태를 로드합니다.
-- `memory_add`: 자동 출처 기록 및 감사가 포함된 사실 추출을 수행합니다.
-- `memory_search`: 통합 시맨틱 + 키워드 검색을 수행합니다.
-- `memory_status`: 시스템 상태 및 메모리 통계를 확인합니다.
-
-## 아키텍처
-
-```
-┌─────────────────┐     ┌──────────────┐     ┌──────────────┐
-│   Claude Code   │     │   Gemini     │     │     GPT      │
-│ (Zero-Config)   │     │  (자율 작동)  │     │  (자율 작동)  │
-└────────┬────────┘     └──────┬───────┘     └──────┬───────┘
-         │                     │                     │
-         └─────────────────────┼─────────────────────┘
-                               │
-                    ┌──────────▼──────────┐
-                    │   MCP Protocol      │
-                    │ (w/ instructions)   │  ← v0.6 신규
-                    └──────────┬──────────┘
-                               │
-                    ┌──────────▼──────────┐
-                    │  mcp-agents-memory  │
-                    │  ┌───────────────┐  │
-                    │  │  Selective    │  │  ← 상위 5개 랭커
-                    │  │  Audit        │  │
-                    │  └───────┬───────┘  │
-                    └──────────┼──────────┘
-                               │
-                    ┌──────────▼──────────┐
-                    │  PostgreSQL + pgvec │
-                    │  (통합 Facts 테이블)  │  ← v0.6 메타데이터 포함
-                    └─────────────────────┘
-```
-
-## 로드맵
-
-- [x] v0.1 — 기본 CRUD 메모리 시스템
-- [x] v0.2 — 동적 주체 생성, pgvector 시맨틱 검색
-- [x] v0.3 — 스마트 브리핑, 원자적 저장 강제
-- [x] v0.4 — Librarian 엔진 (자동 추출 및 해결)
-- [x] v0.5 — 출처 관리 레이어 (모델/플랫폼 신뢰도)
-- [x] v0.6 — **유니버설 자율성**: Zero-Config + 선별적 감사 ← **현재**
-- [ ] v0.8 — **메모리 그래프**: 지식 그래프 연관 추론 및 자동 만료
-- [ ] v1.0 — **프로덕션 준비**: npm 배포 및 벤치마킹
-
-## 라이선스
-MIT