memento-mcp-server 0.1.0

package/dist/tools/tool-registry.js

@@ -0,0 +1,337 @@
+/**
+ * 도구 등록 및 관리 시스템
+ * MCP 클라이언트용 도구들의 중앙 관리
+ */
+export class ToolRegistry {
+    tools = new Map();
+    config;
+    metrics = new Map();
+    cache = new Map();
+    constructor(config) {
+        this.config = {
+            enableLogging: true,
+            enableMetrics: true,
+            maxExecutionTime: 30000, // 30초
+            enableCaching: false,
+            cacheSize: 100,
+            ...config
+        };
+    }
+    /**
+     * 도구 등록
+     */
+    register(tool) {
+        if (this.tools.has(tool.name)) {
+            this.log(`Tool ${tool.name} already exists, replacing`, 'warn');
+        }
+        this.tools.set(tool.name, tool);
+        // 메트릭 초기화
+        if (this.config.enableMetrics) {
+            this.metrics.set(tool.name, {
+                name: tool.name,
+                totalExecutions: 0,
+                successfulExecutions: 0,
+                failedExecutions: 0,
+                averageExecutionTime: 0,
+                lastExecution: null,
+                errorRate: 0
+            });
+        }
+        this.log(`Tool registered: ${tool.name}`);
+    }
+    /**
+     * 도구 등록 (배치)
+     */
+    registerAll(tools) {
+        for (const tool of tools) {
+            this.register(tool);
+        }
+        this.log(`Registered ${tools.length} tools`);
+    }
+    /**
+     * 도구 조회
+     */
+    get(name) {
+        return this.tools.get(name);
+    }
+    /**
+     * 모든 도구 목록 반환
+     */
+    getAll() {
+        return Array.from(this.tools.values());
+    }
+    /**
+     * 도구 실행
+     */
+    async execute(name, params, context) {
+        const tool = this.get(name);
+        if (!tool) {
+            throw new Error(`Unknown tool: ${name}`);
+        }
+        // 캐시 확인
+        if (this.config.enableCaching) {
+            const cacheKey = this.generateCacheKey(name, params);
+            const cached = this.cache.get(cacheKey);
+            if (cached && Date.now() - cached.timestamp < cached.ttl) {
+                this.log(`Cache hit for tool: ${name}`);
+                return cached.result;
+            }
+        }
+        const startTime = Date.now();
+        let result;
+        try {
+            // 타임아웃 설정
+            result = await Promise.race([
+                tool.handler(params, context),
+                new Promise((_, reject) => {
+                    setTimeout(() => {
+                        reject(new Error(`Tool execution timeout: ${name}`));
+                    }, this.config.maxExecutionTime);
+                })
+            ]);
+            // 성공 메트릭 업데이트
+            if (this.config.enableMetrics) {
+                this.updateMetrics(name, true, Date.now() - startTime);
+            }
+            // 캐시 저장
+            if (this.config.enableCaching && result.success) {
+                this.cacheResult(name, params, result);
+            }
+            this.log(`Tool executed successfully: ${name}`, { duration: Date.now() - startTime });
+            return result;
+        }
+        catch (error) {
+            // 실패 메트릭 업데이트
+            if (this.config.enableMetrics) {
+                this.updateMetrics(name, false, Date.now() - startTime);
+            }
+            this.log(`Tool execution failed: ${name}`, { error: error instanceof Error ? error.message : String(error) }, 'error');
+            throw error;
+        }
+    }
+    /**
+     * 도구 존재 여부 확인
+     */
+    has(name) {
+        return this.tools.has(name);
+    }
+    /**
+     * 도구 제거
+     */
+    remove(name) {
+        const removed = this.tools.delete(name);
+        if (removed) {
+            this.metrics.delete(name);
+            this.log(`Tool removed: ${name}`);
+        }
+        return removed;
+    }
+    /**
+     * 모든 도구 제거
+     */
+    clear() {
+        this.tools.clear();
+        this.metrics.clear();
+        this.cache.clear();
+        this.log('All tools cleared');
+    }
+    /**
+     * 도구 개수 반환
+     */
+    size() {
+        return this.tools.size;
+    }
+    /**
+     * 도구 이름 목록 반환
+     */
+    getNames() {
+        return Array.from(this.tools.keys());
+    }
+    /**
+     * 도구 검색 (이름 또는 설명 기반)
+     */
+    search(query) {
+        const lowerQuery = query.toLowerCase();
+        return Array.from(this.tools.values()).filter(tool => tool.name.toLowerCase().includes(lowerQuery) ||
+            tool.description.toLowerCase().includes(lowerQuery));
+    }
+    /**
+     * 도구 카테고리별 그룹화
+     */
+    getByCategory() {
+        const categories = new Map();
+        for (const tool of this.tools.values()) {
+            const category = this.extractCategory(tool.name);
+            if (!categories.has(category)) {
+                categories.set(category, []);
+            }
+            categories.get(category).push(tool);
+        }
+        return categories;
+    }
+    /**
+     * 도구 메트릭 조회
+     */
+    getMetrics(name) {
+        if (name) {
+            const metric = this.metrics.get(name);
+            return metric ? [metric] : [];
+        }
+        return Array.from(this.metrics.values());
+    }
+    /**
+     * 도구 상태 확인
+     */
+    getToolStatus(name) {
+        const tool = this.tools.get(name);
+        const metric = this.metrics.get(name);
+        return {
+            exists: !!tool,
+            lastExecution: metric?.lastExecution || null,
+            errorRate: metric?.errorRate || 0,
+            averageExecutionTime: metric?.averageExecutionTime || 0
+        };
+    }
+    /**
+     * 설정 업데이트
+     */
+    updateConfig(newConfig) {
+        this.config = { ...this.config, ...newConfig };
+        this.log('Configuration updated', { config: this.config });
+    }
+    /**
+     * 캐시 정리
+     */
+    clearCache() {
+        this.cache.clear();
+        this.log('Cache cleared');
+    }
+    /**
+     * 캐시 통계
+     */
+    getCacheStats() {
+        const totalRequests = Array.from(this.metrics.values())
+            .reduce((sum, metric) => sum + metric.totalExecutions, 0);
+        const cacheHits = Array.from(this.metrics.values())
+            .reduce((sum, metric) => sum + metric.successfulExecutions, 0);
+        return {
+            size: this.cache.size,
+            hitRate: totalRequests > 0 ? cacheHits / totalRequests : 0,
+            maxSize: this.config.cacheSize
+        };
+    }
+    /**
+     * 도구 검증
+     */
+    validateTool(tool) {
+        const errors = [];
+        if (!tool.name || tool.name.trim().length === 0) {
+            errors.push('Tool name is required');
+        }
+        if (!tool.description || tool.description.trim().length === 0) {
+            errors.push('Tool description is required');
+        }
+        if (!tool.handler || typeof tool.handler !== 'function') {
+            errors.push('Tool handler must be a function');
+        }
+        if (tool.inputSchema && typeof tool.inputSchema !== 'object') {
+            errors.push('Tool inputSchema must be an object');
+        }
+        return errors;
+    }
+    /**
+     * 모든 도구 검증
+     */
+    validateAllTools() {
+        const results = new Map();
+        for (const [name, tool] of this.tools) {
+            const errors = this.validateTool(tool);
+            if (errors.length > 0) {
+                results.set(name, errors);
+            }
+        }
+        return results;
+    }
+    /**
+     * 메트릭 업데이트
+     */
+    updateMetrics(name, success, executionTime) {
+        const metric = this.metrics.get(name);
+        if (!metric)
+            return;
+        metric.totalExecutions++;
+        if (success) {
+            metric.successfulExecutions++;
+        }
+        else {
+            metric.failedExecutions++;
+        }
+        // 평균 실행 시간 업데이트
+        metric.averageExecutionTime =
+            (metric.averageExecutionTime * (metric.totalExecutions - 1) + executionTime) / metric.totalExecutions;
+        metric.lastExecution = new Date();
+        metric.errorRate = metric.failedExecutions / metric.totalExecutions;
+    }
+    /**
+     * 캐시 키 생성
+     */
+    generateCacheKey(name, params) {
+        return `${name}:${JSON.stringify(params)}`;
+    }
+    /**
+     * 결과 캐시 저장
+     */
+    cacheResult(name, params, result) {
+        if (this.cache.size >= this.config.cacheSize) {
+            // 가장 오래된 항목 제거
+            const oldestKey = this.cache.keys().next().value;
+            if (oldestKey) {
+                this.cache.delete(oldestKey);
+            }
+        }
+        const cacheKey = this.generateCacheKey(name, params);
+        this.cache.set(cacheKey, {
+            result,
+            timestamp: Date.now(),
+            ttl: 5 * 60 * 1000 // 5분
+        });
+    }
+    /**
+     * 카테고리 추출
+     */
+    extractCategory(name) {
+        if (name.includes('memory') || name.includes('remember') || name.includes('recall')) {
+            return 'memory';
+        }
+        if (name.includes('search') || name.includes('find')) {
+            return 'search';
+        }
+        if (name.includes('cleanup') || name.includes('forget')) {
+            return 'maintenance';
+        }
+        if (name.includes('performance') || name.includes('monitor')) {
+            return 'monitoring';
+        }
+        return 'other';
+    }
+    /**
+     * 로깅
+     */
+    log(message, data, level = 'info') {
+        if (!this.config.enableLogging)
+            return;
+        const timestamp = new Date().toISOString();
+        const logMessage = `[${timestamp}] [ToolRegistry] [${level.toUpperCase()}] ${message}`;
+        switch (level) {
+            case 'error':
+                console.error(logMessage, data ? JSON.stringify(data, null, 2) : '');
+                break;
+            case 'warn':
+                console.warn(logMessage, data ? JSON.stringify(data, null, 2) : '');
+                break;
+            default:
+                console.log(logMessage, data ? JSON.stringify(data, null, 2) : '');
+        }
+    }
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/tools/tool-registry.js.map

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

package/dist/tools/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * MCP Tools 공통 타입 정의
+ */
+import { z } from 'zod';
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: any;
+    handler: ToolHandler;
+}
+export interface ToolContext {
+    db: any;
+    services: {
+        searchEngine?: any;
+        hybridSearchEngine?: any;
+        embeddingService?: any;
+        forgettingPolicyService?: any;
+        performanceMonitor?: any;
+        databaseOptimizer?: any;
+        errorLoggingService?: any;
+        performanceAlertService?: any;
+        performanceMonitoringIntegration?: any;
+    };
+}
+export type ToolHandler = (params: any, context: ToolContext) => Promise<any>;
+export interface ToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    [key: string]: any;
+}
+export interface ToolError {
+    error: string;
+    message?: string;
+    details?: string;
+}
+/**
+ * 공통 스키마 정의
+ */
+export declare const CommonSchemas: {
+    MemoryId: z.ZodString;
+    Content: z.ZodString;
+    Query: z.ZodString;
+    MemoryType: z.ZodEnum<["working", "episodic", "semantic", "procedural"]>;
+    PrivacyScope: z.ZodEnum<["private", "team", "public"]>;
+    Importance: z.ZodNumber;
+    Limit: z.ZodDefault<z.ZodNumber>;
+    Tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    Source: z.ZodOptional<z.ZodString>;
+    HardDelete: z.ZodDefault<z.ZodBoolean>;
+    DryRun: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    Analyze: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    CreateIndexes: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,GAAG,CAAC;IACjB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,GAAG,CAAC;IACR,QAAQ,EAAE;QACR,YAAY,CAAC,EAAE,GAAG,CAAC;QACnB,kBAAkB,CAAC,EAAE,GAAG,CAAC;QACzB,gBAAgB,CAAC,EAAE,GAAG,CAAC;QACvB,uBAAuB,CAAC,EAAE,GAAG,CAAC;QAC9B,kBAAkB,CAAC,EAAE,GAAG,CAAC;QACzB,iBAAiB,CAAC,EAAE,GAAG,CAAC;QACxB,mBAAmB,CAAC,EAAE,GAAG,CAAC;QAC1B,uBAAuB,CAAC,EAAE,GAAG,CAAC;QAC9B,gCAAgC,CAAC,EAAE,GAAG,CAAC;KACxC,CAAC;CACH;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAE9E,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;CAczB,CAAC"}

package/dist/tools/types.js

@@ -0,0 +1,23 @@
+/**
+ * MCP Tools 공통 타입 정의
+ */
+import { z } from 'zod';
+/**
+ * 공통 스키마 정의
+ */
+export const CommonSchemas = {
+    MemoryId: z.string().min(1, 'Memory ID cannot be empty'),
+    Content: z.string().min(1, 'Content cannot be empty'),
+    Query: z.string().min(1, 'Query cannot be empty'),
+    MemoryType: z.enum(['working', 'episodic', 'semantic', 'procedural']),
+    PrivacyScope: z.enum(['private', 'team', 'public']),
+    Importance: z.number().min(0).max(1),
+    Limit: z.number().min(1).max(50).default(10),
+    Tags: z.array(z.string()).optional(),
+    Source: z.string().optional(),
+    HardDelete: z.boolean().default(false),
+    DryRun: z.boolean().default(false).optional(),
+    Analyze: z.boolean().default(false).optional(),
+    CreateIndexes: z.boolean().default(false).optional(),
+};
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwCxB;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC;IACxD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC;IACrD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,uBAAuB,CAAC;IACjD,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;IACrE,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACtC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;IAC7C,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;IAC9C,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;CACrD,CAAC"}

package/dist/tools/unpin-tool.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Unpin Tool - 기억 고정 해제 도구
+ * 고정된 기억의 고정을 해제하여 일반 관리 대상으로 변경
+ */
+import { BaseTool } from './base-tool.js';
+import type { ToolContext, ToolResult } from './types.js';
+export declare class UnpinTool extends BaseTool {
+    constructor();
+    handle(params: any, context: ToolContext): Promise<ToolResult>;
+    /**
+     * 단일 기억 고정 해제
+     */
+    private handleSingleUnpin;
+    /**
+     * 배치 고정 해제 처리
+     */
+    private handleBatchUnpin;
+    /**
+     * 기억 조회
+     */
+    private getMemoryById;
+    /**
+     * 고정 해제 로그 기록
+     */
+    private logUnpinAction;
+    /**
+     * 데이터베이스 락 처리
+     */
+    private handleDatabaseLock;
+    /**
+     * 고정 해제 가능한 기억 목록 조회
+     */
+    getUnpinnableMemories(context: ToolContext, limit?: number): Promise<any[]>;
+    /**
+     * 고정 해제 통계 조회
+     */
+    getUnpinStats(context: ToolContext): Promise<any>;
+    /**
+     * 고정 해제 권장 기억 조회
+     */
+    getRecommendedUnpins(context: ToolContext, limit?: number): Promise<any[]>;
+}
+//# sourceMappingURL=unpin-tool.d.ts.map

package/dist/tools/unpin-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unpin-tool.d.ts","sourceRoot":"","sources":["../../src/tools/unpin-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAa1D,qBAAa,SAAU,SAAQ,QAAQ;;IAsC/B,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAkBpE;;OAEG;YACW,iBAAiB;IA8D/B;;OAEG;YACW,gBAAgB;IAmD9B;;OAEG;YACW,aAAa;IAQ3B;;OAEG;YACW,cAAc;IAiB5B;;OAEG;YACW,kBAAkB;IAShC;;OAEG;IACG,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAcrF;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;IA4BvD;;OAEG;IACG,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;CAgBrF"}