memento-mcp-server 0.1.0

package/dist/algorithms/vector-search-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-search-engine.d.ts","sourceRoot":"","sources":["../../src/algorithms/vector-search-engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,EAAE,CAAkC;IAC5C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAO;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAM;;IAMnC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI;IAKvC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAkD5B;;OAEG;IACG,MAAM,CACV,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,GAAE,mBAAwB,EACjC,QAAQ,GAAE,MAAgB,GACzB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IA4EhC;;;OAGG;IACG,YAAY,CAChB,WAAW,EAAE,MAAM,EAAE,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,mBAAwB,EACjC,QAAQ,GAAE,MAAgB,GACzB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IA6HhC;;OAEG;IACH,cAAc,IAAI,iBAAiB;IAgDnC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAkBtC;;OAEG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,UAAU,GAAE,MAAW,GAAG,OAAO,CAAC;QAC7E,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IAwCF;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,WAAW,IAAI,OAAO;CAGvB;AAKD,wBAAgB,qBAAqB,IAAI,kBAAkB,CAK1D;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/algorithms/vector-search-engine.js

@@ -0,0 +1,410 @@
+/**
+ * 벡터 검색 엔진
+ * sqlite-vec를 사용한 벡터 유사도 검색
+ * Memento MCP Server의 핵심 벡터 검색 컴포넌트
+ */
+import Database from 'better-sqlite3';
+export class VectorSearchEngine {
+    db = null;
+    isVecAvailable = false;
+    vecExtensionLoaded = false;
+    defaultDimensions = 1536;
+    defaultThreshold = 0.7;
+    defaultLimit = 10;
+    constructor() {
+        // VEC 사용 가능 여부는 데이터베이스 연결 시 확인
+    }
+    /**
+     * 제공자별 vec0 테이블명 반환
+     */
+    getVectorTableName(provider) {
+        switch (provider) {
+            case 'tfidf':
+                return 'memory_item_vec_tfidf';
+            case 'minilm':
+                return 'memory_item_vec_minilm';
+            case 'openai':
+                return 'memory_item_vec_openai';
+            case 'gemini':
+                return 'memory_item_vec_gemini';
+            default:
+                return 'memory_item_vec_tfidf'; // 기본값
+        }
+    }
+    /**
+     * 데이터베이스 초기화
+     */
+    initialize(db) {
+        this.db = db;
+        this.checkVecAvailability();
+    }
+    /**
+     * VEC 사용 가능 여부 확인
+     * sqlite-vec 확장 로드 여부와 테이블 존재를 모두 확인
+     */
+    checkVecAvailability() {
+        if (!this.db) {
+            this.isVecAvailable = false;
+            this.vecExtensionLoaded = false;
+            return;
+        }
+        try {
+            // 1. 제공자별 vec0 테이블 중 하나라도 존재하는지 확인
+            const tableCheck = this.db.prepare(`
+        SELECT name FROM sqlite_master 
+        WHERE type='table' AND name IN (
+          'memory_item_vec_tfidf',
+          'memory_item_vec_minilm', 
+          'memory_item_vec_openai',
+          'memory_item_vec_gemini'
+        )
+      `).all();
+            if (tableCheck.length === 0) {
+                console.log('⚠️ VEC 테이블이 없습니다. 벡터 검색이 비활성화됩니다.');
+                this.isVecAvailable = false;
+                this.vecExtensionLoaded = false;
+                return;
+            }
+            // 2. VEC 함수 사용 가능 여부 확인 (첫 번째 테이블로 테스트)
+            try {
+                const testTable = tableCheck[0].name;
+                this.db.prepare(`
+          SELECT distance FROM ${testTable} 
+          WHERE embedding MATCH ? 
+          LIMIT 0
+        `).get(JSON.stringify(new Array(this.defaultDimensions).fill(0)));
+                this.vecExtensionLoaded = true;
+                this.isVecAvailable = true;
+                console.log('✅ VEC (Vector Search) 사용 가능');
+            }
+            catch (vecError) {
+                console.warn('⚠️ VEC 함수를 사용할 수 없습니다:', vecError);
+                this.vecExtensionLoaded = false;
+                this.isVecAvailable = false;
+            }
+        }
+        catch (error) {
+            console.error('❌ VEC 가용성 확인 실패:', error);
+            this.isVecAvailable = false;
+            this.vecExtensionLoaded = false;
+        }
+    }
+    /**
+     * 벡터 검색 실행
+     */
+    async search(queryVector, options = {}, provider = 'tfidf') {
+        if (!this.db || !this.isVecAvailable) {
+            console.warn('⚠️ VEC를 사용할 수 없습니다. 빈 결과를 반환합니다.');
+            return [];
+        }
+        const { limit = this.defaultLimit, threshold = this.defaultThreshold, type, includeContent = true, includeMetadata = false } = options;
+        // 벡터 차원 검증
+        if (queryVector.length !== this.defaultDimensions) {
+            console.error(`❌ 벡터 차원 불일치: 예상 ${this.defaultDimensions}, 실제 ${queryVector.length}`);
+            return [];
+        }
+        try {
+            // 제공자별 테이블명 결정
+            const tableName = this.getVectorTableName(provider);
+            // VEC 검색 쿼리 (제공자별 vec0 테이블 사용)
+            const vecQuery = `
+        SELECT 
+          vec.rowid as memory_id,
+          vec.distance as similarity,
+          mi.content,
+          mi.type,
+          mi.importance,
+          mi.created_at,
+          mi.last_accessed,
+          mi.pinned,
+          mi.tags
+        FROM ${tableName} vec
+        JOIN memory_item mi ON vec.rowid = mi.id
+        WHERE vec.embedding MATCH ?
+        ${type ? 'AND mi.type = ?' : ''}
+        ORDER BY vec.distance ASC
+        LIMIT ?
+      `;
+            const params = [JSON.stringify(queryVector), ...(type ? [type] : []), limit];
+            const results = this.db.prepare(vecQuery).all(...params);
+            // 유사도를 0-1 범위로 정규화 (distance는 작을수록 유사함)
+            const normalizedResults = results
+                .map(result => ({
+                ...result,
+                similarity: Math.max(0, 1 - result.similarity), // distance를 similarity로 변환
+                tags: result.tags ? JSON.parse(result.tags) : undefined
+            }))
+                .filter(result => result.similarity >= threshold)
+                .map(result => ({
+                memory_id: result.memory_id,
+                similarity: result.similarity,
+                content: includeContent ? result.content : '',
+                type: result.type,
+                importance: result.importance,
+                created_at: result.created_at,
+                last_accessed: includeMetadata ? result.last_accessed : undefined,
+                pinned: includeMetadata ? Boolean(result.pinned) : false,
+                tags: includeMetadata ? result.tags : undefined
+            }));
+            console.log(`🔍 벡터 검색 완료: ${normalizedResults.length}개 결과 (임계값: ${threshold})`);
+            return normalizedResults;
+        }
+        catch (error) {
+            console.error('❌ 벡터 검색 실패:', error);
+            return [];
+        }
+    }
+    /**
+     * 하이브리드 검색 (벡터 + 메타데이터)
+     * SQLite 호환성을 위해 LEFT JOIN 사용
+     */
+    async hybridSearch(queryVector, textQuery, options = {}, provider = 'tfidf') {
+        if (!this.db || !this.isVecAvailable) {
+            console.warn('⚠️ VEC를 사용할 수 없습니다. 빈 결과를 반환합니다.');
+            return [];
+        }
+        const { limit = this.defaultLimit, threshold = this.defaultThreshold, type, includeContent = true, includeMetadata = true } = options;
+        // 벡터 차원 검증
+        if (queryVector.length !== this.defaultDimensions) {
+            console.error(`❌ 벡터 차원 불일치: 예상 ${this.defaultDimensions}, 실제 ${queryVector.length}`);
+            return [];
+        }
+        try {
+            // 제공자별 테이블명 결정
+            const tableName = this.getVectorTableName(provider);
+            // 벡터 검색과 텍스트 검색을 결합한 하이브리드 쿼리 (SQLite 호환)
+            const hybridQuery = `
+        WITH vector_search AS (
+          SELECT 
+            vec.rowid as memory_id,
+            vec.distance as vector_distance,
+            mi.content,
+            mi.type,
+            mi.importance,
+            mi.created_at,
+            mi.last_accessed,
+            mi.pinned,
+            mi.tags
+          FROM ${tableName} vec
+          JOIN memory_item mi ON vec.rowid = mi.id
+          WHERE vec.embedding MATCH ?
+          ${type ? 'AND mi.type = ?' : ''}
+        ),
+        text_search AS (
+          SELECT 
+            mi.id as memory_id,
+            mi.content,
+            mi.type,
+            mi.importance,
+            mi.created_at,
+            mi.last_accessed,
+            mi.pinned,
+            mi.tags,
+            fts.rank as text_rank
+          FROM memory_item_fts fts
+          JOIN memory_item mi ON fts.rowid = mi.rowid
+          WHERE memory_item_fts MATCH ?
+          ${type ? 'AND mi.type = ?' : ''}
+        )
+        SELECT 
+          COALESCE(vs.memory_id, ts.memory_id) as memory_id,
+          COALESCE(1 - vs.vector_distance, 0) as vector_similarity,
+          COALESCE(ts.text_rank, 0) as text_similarity,
+          COALESCE(vs.content, ts.content) as content,
+          COALESCE(vs.type, ts.type) as type,
+          COALESCE(vs.importance, ts.importance) as importance,
+          COALESCE(vs.created_at, ts.created_at) as created_at,
+          COALESCE(vs.last_accessed, ts.last_accessed) as last_accessed,
+          COALESCE(vs.pinned, ts.pinned) as pinned,
+          COALESCE(vs.tags, ts.tags) as tags
+        FROM vector_search vs
+        LEFT JOIN text_search ts ON vs.memory_id = ts.memory_id
+        WHERE vs.memory_id IS NOT NULL
+        UNION
+        SELECT 
+          ts.memory_id,
+          0 as vector_similarity,
+          ts.text_rank as text_similarity,
+          ts.content,
+          ts.type,
+          ts.importance,
+          ts.created_at,
+          ts.last_accessed,
+          ts.pinned,
+          ts.tags
+        FROM text_search ts
+        LEFT JOIN vector_search vs ON ts.memory_id = vs.memory_id
+        WHERE vs.memory_id IS NULL
+        ORDER BY (vector_similarity * 0.6 + text_similarity * 0.4) DESC
+        LIMIT ?
+      `;
+            const params = [
+                JSON.stringify(queryVector),
+                ...(type ? [type] : []),
+                textQuery,
+                ...(type ? [type] : []),
+                limit
+            ];
+            const results = this.db.prepare(hybridQuery).all(...params);
+            // 결과 정규화
+            const normalizedResults = results
+                .map(result => ({
+                memory_id: result.memory_id,
+                similarity: result.vector_similarity * 0.6 + result.text_similarity * 0.4,
+                content: includeContent ? result.content : '',
+                type: result.type,
+                importance: result.importance,
+                created_at: result.created_at,
+                last_accessed: includeMetadata ? result.last_accessed : undefined,
+                pinned: includeMetadata ? Boolean(result.pinned) : false,
+                tags: includeMetadata && result.tags ? JSON.parse(result.tags) : undefined
+            }))
+                .filter(result => result.similarity >= threshold);
+            console.log(`🔍 하이브리드 검색 완료: ${normalizedResults.length}개 결과`);
+            return normalizedResults;
+        }
+        catch (error) {
+            console.error('❌ 하이브리드 검색 실패:', error);
+            return [];
+        }
+    }
+    /**
+     * 벡터 인덱스 상태 확인
+     */
+    getIndexStatus() {
+        if (!this.db) {
+            return {
+                available: false,
+                tableExists: false,
+                recordCount: 0,
+                dimensions: this.defaultDimensions,
+                vecExtensionLoaded: false
+            };
+        }
+        try {
+            const tableExists = this.isVecAvailable;
+            let recordCount = 0;
+            if (tableExists) {
+                // 모든 제공자별 테이블의 레코드 수 합계
+                const providers = ['tfidf', 'minilm', 'openai', 'gemini'];
+                for (const provider of providers) {
+                    const tableName = this.getVectorTableName(provider);
+                    try {
+                        const result = this.db.prepare(`SELECT COUNT(*) as count FROM ${tableName}`).get();
+                        recordCount += result.count;
+                    }
+                    catch (error) {
+                        // 테이블이 존재하지 않는 경우 무시
+                    }
+                }
+            }
+            return {
+                available: this.isVecAvailable,
+                tableExists,
+                recordCount,
+                dimensions: this.defaultDimensions,
+                vecExtensionLoaded: this.vecExtensionLoaded
+            };
+        }
+        catch (error) {
+            console.error('❌ 인덱스 상태 확인 실패:', error);
+            return {
+                available: false,
+                tableExists: false,
+                recordCount: 0,
+                dimensions: this.defaultDimensions,
+                vecExtensionLoaded: false
+            };
+        }
+    }
+    /**
+     * 벡터 인덱스 재구성
+     */
+    async rebuildIndex() {
+        if (!this.db || !this.isVecAvailable) {
+            console.warn('⚠️ VEC를 사용할 수 없습니다.');
+            return false;
+        }
+        try {
+            console.log('🔄 벡터 인덱스 재구성 시작...');
+            // VEC 인덱스 재구성 (sqlite-vec는 자동으로 인덱스를 관리)
+            console.log('✅ 벡터 인덱스 재구성 완료 (sqlite-vec는 자동 인덱스 관리)');
+            return true;
+        }
+        catch (error) {
+            console.error('❌ 벡터 인덱스 재구성 실패:', error);
+            return false;
+        }
+    }
+    /**
+     * 벡터 검색 성능 테스트
+     */
+    async performanceTest(queryVector, iterations = 10) {
+        if (!this.db || !this.isVecAvailable) {
+            return { averageTime: 0, minTime: 0, maxTime: 0, results: 0, successRate: 0 };
+        }
+        const times = [];
+        let resultCount = 0;
+        let successCount = 0;
+        for (let i = 0; i < iterations; i++) {
+            try {
+                const startTime = Date.now();
+                const results = await this.search(queryVector, { limit: 10 });
+                const endTime = Date.now();
+                times.push(endTime - startTime);
+                if (i === 0)
+                    resultCount = results.length;
+                successCount++;
+            }
+            catch (error) {
+                console.warn(`⚠️ 성능 테스트 ${i + 1}회차 실패:`, error);
+                times.push(0);
+            }
+        }
+        const averageTime = times.reduce((a, b) => a + b, 0) / times.length;
+        const minTime = Math.min(...times.filter(t => t > 0));
+        const maxTime = Math.max(...times);
+        const successRate = successCount / iterations;
+        console.log(`🔍 벡터 검색 성능 테스트: 평균 ${averageTime.toFixed(2)}ms (${iterations}회, 성공률: ${(successRate * 100).toFixed(1)}%)`);
+        return {
+            averageTime,
+            minTime: minTime || 0,
+            maxTime,
+            results: resultCount,
+            successRate
+        };
+    }
+    /**
+     * 벡터 차원 확인
+     */
+    getDimensions() {
+        return this.defaultDimensions;
+    }
+    /**
+     * VEC 사용 가능 여부 확인
+     */
+    isAvailable() {
+        return this.isVecAvailable;
+    }
+    /**
+     * 데이터베이스 연결 상태 확인
+     */
+    isConnected() {
+        return this.db !== null;
+    }
+}
+// 싱글톤 인스턴스
+let vectorSearchEngineInstance = null;
+export function getVectorSearchEngine() {
+    if (!vectorSearchEngineInstance) {
+        vectorSearchEngineInstance = new VectorSearchEngine();
+    }
+    return vectorSearchEngineInstance;
+}
+export function createVectorSearchEngine() {
+    return new VectorSearchEngine();
+}
+export function resetVectorSearchEngine() {
+    vectorSearchEngineInstance = null;
+}
+//# sourceMappingURL=vector-search-engine.js.map

package/dist/algorithms/vector-search-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-search-engine.js","sourceRoot":"","sources":["../../src/algorithms/vector-search-engine.ts"],"names":[],"mappings":"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"}

package/dist/client/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Memento MCP Client
+ * MCP 서버와 통신하는 클라이언트 라이브러리
+ */
+import type { RememberParams, RecallParams, ForgetParams, PinParams, UnpinParams, MemorySearchResult } from '../types/index.js';
+export declare class MementoClient {
+    private client;
+    private connected;
+    constructor();
+    /**
+     * MCP 서버에 연결
+     */
+    connect(): Promise<void>;
+    /**
+     * 연결 해제
+     */
+    disconnect(): Promise<void>;
+    /**
+     * 기억 저장
+     */
+    remember(params: RememberParams): Promise<string>;
+    /**
+     * 기억 검색
+     */
+    recall(params: RecallParams): Promise<MemorySearchResult[]>;
+    /**
+     * 기억 삭제
+     */
+    forget(params: ForgetParams): Promise<string>;
+    /**
+     * 기억 고정
+     */
+    pin(params: PinParams): Promise<string>;
+    /**
+     * 기억 고정 해제
+     */
+    unpin(params: UnpinParams): Promise<string>;
+    /**
+     * 연결 상태 확인
+     */
+    private ensureConnected;
+    /**
+     * 연결 상태 반환
+     */
+    isConnected(): boolean;
+    /**
+     * 일반적인 도구 호출
+     */
+    callTool(name: string, args?: Record<string, any>): Promise<any>;
+}
+/**
+ * 간편한 사용을 위한 팩토리 함수
+ */
+export declare function createMementoClient(): MementoClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAGV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,WAAW,EACX,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAkB;;IAkBnC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBvD;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAiBjE;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBnD;;OAEG;IACG,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAgB7C;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBjD;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,OAAO,CAAC,GAAG,CAAC;CA6B3E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD"}

package/dist/client/index.js

@@ -0,0 +1,179 @@
+/**
+ * Memento MCP Client
+ * MCP 서버와 통신하는 클라이언트 라이브러리
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+export class MementoClient {
+    client;
+    connected = false;
+    constructor() {
+        this.client = new Client({
+            name: 'memento-client',
+            version: '0.1.0'
+        }, {
+            capabilities: {
+                tools: {},
+                resources: {},
+                prompts: {}
+            }
+        });
+    }
+    /**
+     * MCP 서버에 연결
+     */
+    async connect() {
+        try {
+            // stdio를 통해 서버에 연결
+            const transport = new StdioClientTransport({
+                command: 'node',
+                args: ['dist/server/index.js']
+            });
+            await this.client.connect(transport);
+            this.connected = true;
+            console.log('✅ Memento MCP 서버에 연결되었습니다');
+        }
+        catch (error) {
+            console.error('❌ MCP 서버 연결 실패:', error);
+            throw error;
+        }
+    }
+    /**
+     * 연결 해제
+     */
+    async disconnect() {
+        if (this.connected) {
+            await this.client.close();
+            this.connected = false;
+            console.log('🔌 MCP 서버 연결이 해제되었습니다');
+        }
+    }
+    /**
+     * 기억 저장
+     */
+    async remember(params) {
+        this.ensureConnected();
+        const result = await this.client.callTool({
+            name: 'remember',
+            arguments: params
+        });
+        if (result.content && Array.isArray(result.content) && result.content[0] && 'text' in result.content[0]) {
+            const response = JSON.parse(result.content[0].text);
+            return response.memory_id;
+        }
+        throw new Error('기억 저장에 실패했습니다');
+    }
+    /**
+     * 기억 검색
+     */
+    async recall(params) {
+        this.ensureConnected();
+        const result = await this.client.callTool({
+            name: 'recall',
+            arguments: params
+        });
+        if (result.content && Array.isArray(result.content) && result.content[0] && 'text' in result.content[0]) {
+            const response = JSON.parse(result.content[0].text);
+            // 응답 구조: { items: { items: [...], total_count: ..., query_time: ... }, ... }
+            return response.items?.items || [];
+        }
+        throw new Error('기억 검색에 실패했습니다');
+    }
+    /**
+     * 기억 삭제
+     */
+    async forget(params) {
+        this.ensureConnected();
+        const result = await this.client.callTool({
+            name: 'forget',
+            arguments: params
+        });
+        if (result.content && Array.isArray(result.content) && result.content[0] && 'text' in result.content[0]) {
+            const response = JSON.parse(result.content[0].text);
+            return response.message;
+        }
+        throw new Error('기억 삭제에 실패했습니다');
+    }
+    /**
+     * 기억 고정
+     */
+    async pin(params) {
+        this.ensureConnected();
+        const result = await this.client.callTool({
+            name: 'pin',
+            arguments: params
+        });
+        if (result.content && Array.isArray(result.content) && result.content[0] && 'text' in result.content[0]) {
+            const response = JSON.parse(result.content[0].text);
+            return response.message;
+        }
+        throw new Error('기억 고정에 실패했습니다');
+    }
+    /**
+     * 기억 고정 해제
+     */
+    async unpin(params) {
+        this.ensureConnected();
+        const result = await this.client.callTool({
+            name: 'unpin',
+            arguments: params
+        });
+        if (result.content && Array.isArray(result.content) && result.content[0] && 'text' in result.content[0]) {
+            const response = JSON.parse(result.content[0].text);
+            return response.message;
+        }
+        throw new Error('기억 고정 해제에 실패했습니다');
+    }
+    /**
+     * 연결 상태 확인
+     */
+    ensureConnected() {
+        if (!this.connected) {
+            throw new Error('MCP 서버에 연결되지 않았습니다. connect()를 먼저 호출하세요.');
+        }
+    }
+    /**
+     * 연결 상태 반환
+     */
+    isConnected() {
+        return this.connected;
+    }
+    /**
+     * 일반적인 도구 호출
+     */
+    async callTool(name, args = {}) {
+        if (!this.connected) {
+            throw new Error('서버에 연결되지 않았습니다');
+        }
+        try {
+            const result = await this.client.callTool({
+                name,
+                arguments: args
+            });
+            // 결과 파싱
+            if (result.content && Array.isArray(result.content) && result.content.length > 0) {
+                const content = result.content[0];
+                if (content.type === 'text') {
+                    try {
+                        return JSON.parse(content.text);
+                    }
+                    catch {
+                        return content.text;
+                    }
+                }
+                return content;
+            }
+            return result;
+        }
+        catch (error) {
+            throw new Error(`도구 호출 실패 (${name}): ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+}
+/**
+ * 간편한 사용을 위한 팩토리 함수
+ */
+export function createMementoClient() {
+    return new MementoClient();
+}
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"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"}