memento-mcp-server 1.11.0 → 1.11.1

package/dist/server/routes/mcp.routes.js

@@ -0,0 +1,383 @@
+/**
+ * MCP 라우터
+ * /mcp, /messages 엔드포인트 처리
+ * Phase 1.2: http-server.ts 리팩토링
+ */
+import { Router } from 'express';
+import { getToolRegistry } from '../../tools/index.js';
+import { createToolContext } from '../context.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * MCP 라우터 생성
+ */
+export function createMcpRouter(db, serverServices, transports) {
+    const router = Router();
+    // MCP SSE 엔드포인트
+    router.get('/mcp', async (req, res) => {
+        logger.info('MCP SSE client connection request');
+        try {
+            // SSE 헤더 설정
+            res.writeHead(200, {
+                'Content-Type': 'text/event-stream',
+                'Cache-Control': 'no-cache, no-transform',
+                'Connection': 'keep-alive',
+                'Access-Control-Allow-Origin': '*',
+                'Access-Control-Allow-Headers': 'Cache-Control, Content-Type, Authorization',
+                'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',
+                'X-Accel-Buffering': 'no'
+            });
+            // 세션 ID 생성
+            const sessionId = `session_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+            // 엔드포인트 이벤트 전송
+            const endpointUrl = `/messages?sessionId=${sessionId}`;
+            res.write(`event: endpoint\ndata: ${endpointUrl}\n\n`);
+            // MCP 서버 준비 완료 알림
+            res.write(`data: {"type": "ready"}\n\n`);
+            // Keep-alive ping 전송
+            const keepAliveInterval = setInterval(() => {
+                if (res.writableEnded) {
+                    clearInterval(keepAliveInterval);
+                    return;
+                }
+                try {
+                    res.write(`data: {"type": "ping"}\n\n`);
+                }
+                catch (error) {
+                    clearInterval(keepAliveInterval);
+                }
+            }, 30000); // 30초마다 ping
+            // Transport 정보 저장
+            transports[sessionId] = {
+                res: res,
+                sessionId: sessionId,
+                keepAliveInterval: keepAliveInterval
+            };
+            // 연결 종료 처리
+            req.on('close', () => {
+                logger.info('MCP SSE client connection closed', { sessionId });
+                clearInterval(keepAliveInterval);
+                delete transports[sessionId];
+            });
+            req.on('error', (error) => {
+                if (error.code === 'ECONNRESET') {
+                    logger.info('MCP SSE client connection closed (normal)', { sessionId });
+                }
+                else {
+                    logger.error('MCP SSE connection error', {
+                        sessionId,
+                        error: error instanceof Error ? error.message : String(error)
+                    });
+                }
+                clearInterval(keepAliveInterval);
+                delete transports[sessionId];
+            });
+            logger.info('MCP SSE stream setup completed', { sessionId });
+            return;
+        }
+        catch (error) {
+            logger.error('SSE stream setup failed', {
+                error: error instanceof Error ? error.message : String(error)
+            });
+            if (!res.headersSent) {
+                res.status(500).send('Error establishing SSE stream');
+            }
+            return;
+        }
+    });
+    // Messages 엔드포인트 (JSON-RPC 요청 수신)
+    router.post('/messages', async (req, res) => {
+        logger.info('MCP message received', { method: req.body.method });
+        // 세션 ID 추출
+        const sessionId = req.query.sessionId;
+        if (!sessionId) {
+            logger.error('No session ID provided in request URL');
+            res.status(400).send('Missing sessionId parameter');
+            return;
+        }
+        const transport = transports[sessionId];
+        if (!transport) {
+            logger.error('No active transport found for session ID', { sessionId });
+            res.status(404).send('Session not found');
+            return;
+        }
+        const message = req.body;
+        let result;
+        try {
+            if (message.method === 'initialize') {
+                logger.info('MCP initialize request processing');
+                result = {
+                    jsonrpc: '2.0',
+                    id: message.id,
+                    result: {
+                        protocolVersion: '2024-11-05',
+                        capabilities: {
+                            tools: {}
+                        },
+                        serverInfo: {
+                            name: 'memento-memory',
+                            version: '0.1.0'
+                        }
+                    }
+                };
+            }
+            else if (message.method === 'notifications/initialized') {
+                logger.info('MCP initialized notification received');
+                result = {
+                    jsonrpc: '2.0',
+                    id: message.id,
+                    result: {}
+                };
+            }
+            else if (message.method === 'tools/list') {
+                logger.info('MCP tools/list request processing');
+                try {
+                    const toolRegistry = getToolRegistry();
+                    const tools = toolRegistry.getAll();
+                    result = {
+                        jsonrpc: '2.0',
+                        id: message.id,
+                        result: { tools }
+                    };
+                    // SSE 응답 즉시 전송
+                    if (transport && transport.res && !transport.res.writableEnded) {
+                        const sseData = `data: ${JSON.stringify(result)}\n\n`;
+                        transport.res.write(sseData);
+                    }
+                    // HTTP 응답 전송
+                    res.json({ status: 'ok' });
+                    return;
+                }
+                catch (toolsError) {
+                    logger.error('tools/list processing error', {
+                        error: toolsError instanceof Error ? toolsError.message : String(toolsError)
+                    });
+                    const errorResult = {
+                        jsonrpc: '2.0',
+                        id: message.id,
+                        error: {
+                            code: -32603,
+                            message: 'Internal error',
+                            data: toolsError instanceof Error ? toolsError.message : String(toolsError)
+                        }
+                    };
+                    if (transport && transport.res && !transport.res.writableEnded) {
+                        transport.res.write(`data: ${JSON.stringify(errorResult)}\n\n`);
+                    }
+                    res.json({ status: 'error' });
+                    return;
+                }
+            }
+            else if (message.method === 'tools/call') {
+                const { name, arguments: args } = message.params;
+                if (!serverServices) {
+                    result = {
+                        jsonrpc: '2.0',
+                        id: message.id,
+                        error: {
+                            code: -32603,
+                            message: 'Internal error',
+                            data: '서비스가 초기화되지 않았습니다'
+                        }
+                    };
+                }
+                else {
+                    // ToolContext 생성 (Phase 0의 공통 모듈 사용)
+                    const serverContext = {
+                        db: db,
+                        services: serverServices
+                    };
+                    const toolContext = createToolContext(serverContext);
+                    // 도구 실행
+                    const toolRegistry = getToolRegistry();
+                    const toolResult = await toolRegistry.execute(name, args, toolContext);
+                    result = {
+                        jsonrpc: '2.0',
+                        id: message.id,
+                        result: { content: [{ type: 'text', text: JSON.stringify(toolResult) }] }
+                    };
+                }
+            }
+            else if (message.method === 'prompts/list') {
+                logger.info('MCP prompts/list request processing');
+                const prompts = [
+                    {
+                        name: 'memory_injection',
+                        description: '관련 기억을 요약하여 프롬프트에 주입',
+                        arguments: [
+                            {
+                                name: 'query',
+                                description: '검색할 쿼리',
+                                required: true
+                            },
+                            {
+                                name: 'token_budget',
+                                description: '토큰 예산 (기본값: 1000)',
+                                required: false
+                            },
+                            {
+                                name: 'max_memories',
+                                description: '최대 기억 개수 (기본값: 5)',
+                                required: false
+                            }
+                        ]
+                    }
+                ];
+                result = {
+                    jsonrpc: '2.0',
+                    id: message.id,
+                    result: { prompts }
+                };
+            }
+            else if (message.method === 'prompts/get') {
+                const { name } = message.params;
+                if (name === 'memory_injection') {
+                    result = {
+                        jsonrpc: '2.0',
+                        id: message.id,
+                        result: {
+                            description: '관련 기억을 요약하여 프롬프트에 주입',
+                            arguments: [
+                                {
+                                    name: 'query',
+                                    description: '검색할 쿼리',
+                                    required: true
+                                },
+                                {
+                                    name: 'token_budget',
+                                    description: '토큰 예산 (기본값: 1000)',
+                                    required: false
+                                },
+                                {
+                                    name: 'max_memories',
+                                    description: '최대 기억 개수 (기본값: 5)',
+                                    required: false
+                                }
+                            ]
+                        }
+                    };
+                }
+                else {
+                    result = {
+                        jsonrpc: '2.0',
+                        id: message.id,
+                        error: {
+                            code: -32601,
+                            message: 'Prompt not found'
+                        }
+                    };
+                }
+            }
+            else if (message.method === 'prompts/call') {
+                const { name, arguments: args } = message.params;
+                if (name === 'memory_injection') {
+                    try {
+                        if (!serverServices) {
+                            result = {
+                                jsonrpc: '2.0',
+                                id: message.id,
+                                error: {
+                                    code: -32603,
+                                    message: 'Internal error',
+                                    data: '서비스가 초기화되지 않았습니다'
+                                }
+                            };
+                        }
+                        else {
+                            // MemoryInjectionPrompt 도구 사용
+                            const toolRegistry = getToolRegistry();
+                            const serverContext = {
+                                db: db,
+                                services: serverServices
+                            };
+                            const toolContext = createToolContext(serverContext);
+                            const promptResult = await toolRegistry.execute('memory_injection', args, toolContext);
+                            result = {
+                                jsonrpc: '2.0',
+                                id: message.id,
+                                result: promptResult
+                            };
+                        }
+                    }
+                    catch (error) {
+                        result = {
+                            jsonrpc: '2.0',
+                            id: message.id,
+                            error: {
+                                code: -32603,
+                                message: 'Prompt execution failed',
+                                data: error instanceof Error ? error.message : 'Unknown error'
+                            }
+                        };
+                    }
+                }
+                else {
+                    result = {
+                        jsonrpc: '2.0',
+                        id: message.id,
+                        error: {
+                            code: -32601,
+                            message: 'Prompt not found'
+                        }
+                    };
+                }
+            }
+            else {
+                result = {
+                    jsonrpc: '2.0',
+                    id: message.id,
+                    error: {
+                        code: -32601,
+                        message: 'Method not found'
+                    }
+                };
+            }
+            // SSE 응답 전송
+            try {
+                if (!transport || !transport.res || transport.res.writableEnded) {
+                    logger.error('SSE transport invalid');
+                    res.status(500).json({ error: 'SSE transport invalid' });
+                    return;
+                }
+                const sseData = `data: ${JSON.stringify(result)}\n\n`;
+                transport.res.write(sseData);
+            }
+            catch (sseError) {
+                logger.error('SSE response send failed', {
+                    error: sseError instanceof Error ? sseError.message : String(sseError)
+                });
+            }
+            // HTTP 응답 전송
+            res.json({ status: 'ok' });
+        }
+        catch (error) {
+            logger.error('MCP message processing failed', {
+                error: error instanceof Error ? error.message : String(error)
+            });
+            const errorResponse = {
+                jsonrpc: '2.0',
+                id: message?.id || null,
+                error: {
+                    code: -32603,
+                    message: 'Internal error',
+                    data: error instanceof Error ? error.message : 'Unknown error'
+                }
+            };
+            // SSE 에러 응답 전송
+            try {
+                if (transport && transport.res && !transport.res.writableEnded) {
+                    const errorSseData = `data: ${JSON.stringify(errorResponse)}\n\n`;
+                    transport.res.write(errorSseData);
+                }
+            }
+            catch (errorSseError) {
+                logger.error('SSE error response send failed', {
+                    error: errorSseError instanceof Error ? errorSseError.message : String(errorSseError)
+                });
+            }
+            // HTTP 응답 전송
+            res.json({ status: 'error' });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=mcp.routes.js.map

package/dist/server/routes/mcp.routes.js.map

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

package/dist/server/routes/tools.routes.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Tools 라우터
+ * /tools/* 엔드포인트 처리
+ * Phase 1.2: http-server.ts 리팩토링
+ */
+import { Router } from 'express';
+import type { ServerServices } from '../bootstrap.js';
+import type Database from 'better-sqlite3';
+/**
+ * Tools 라우터 생성
+ */
+export declare function createToolsRouter(db: Database.Database, serverServices: ServerServices | null, anchorMapSubscribers: Map<string, Set<any>>): Router;
+//# sourceMappingURL=tools.routes.d.ts.map

package/dist/server/routes/tools.routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.routes.d.ts","sourceRoot":"","sources":["../../../src/server/routes/tools.routes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAI3C;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,cAAc,EAAE,cAAc,GAAG,IAAI,EACrC,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAC1C,MAAM,CA4FR"}

package/dist/server/routes/tools.routes.js

@@ -0,0 +1,99 @@
+/**
+ * Tools 라우터
+ * /tools/* 엔드포인트 처리
+ * Phase 1.2: http-server.ts 리팩토링
+ */
+import { Router } from 'express';
+import { getToolRegistry } from '../../tools/index.js';
+import { broadcastAnchorMapUpdate } from '../handlers/anchor-map.handler.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * Tools 라우터 생성
+ */
+export function createToolsRouter(db, serverServices, anchorMapSubscribers) {
+    const router = Router();
+    // 도구 목록 조회
+    router.get('/', (req, res) => {
+        try {
+            const toolRegistry = getToolRegistry();
+            const tools = toolRegistry.getAll();
+            res.json({
+                tools,
+                count: tools.length,
+                server: 'Memento MCP Server'
+            });
+        }
+        catch (error) {
+            logger.error('Tool list retrieval failed', {
+                error: error instanceof Error ? error.message : String(error)
+            });
+            res.status(500).json({
+                error: 'Failed to get tools',
+                message: error instanceof Error ? error.message : 'Unknown error'
+            });
+        }
+    });
+    // 도구 실행
+    router.post('/:name', async (req, res) => {
+        const { name } = req.params;
+        const params = req.body;
+        try {
+            const toolRegistry = getToolRegistry();
+            // Phase 0: 미들웨어에서 주입된 ToolContext 사용
+            if (!req.toolContext) {
+                return res.status(500).json({
+                    error: 'ToolContext not initialized',
+                    message: 'ToolContext가 초기화되지 않았습니다. tool-context 미들웨어를 먼저 적용하세요.'
+                });
+            }
+            const toolContext = req.toolContext;
+            // 도구 실행
+            const toolResult = await toolRegistry.execute(name, params, toolContext);
+            // MCP 형식의 ToolResult에서 실제 데이터 추출
+            let actualResult = toolResult;
+            if (toolResult.content && Array.isArray(toolResult.content) && toolResult.content.length > 0) {
+                const firstContent = toolResult.content[0];
+                if (firstContent && firstContent.text) {
+                    try {
+                        const textContent = firstContent.text;
+                        actualResult = JSON.parse(textContent);
+                    }
+                    catch (parseError) {
+                        // JSON 파싱 실패 시 원본 content 사용
+                        actualResult = toolResult;
+                    }
+                }
+            }
+            // 앵커 관련 도구 실행 후 WebSocket 브로드캐스트
+            if (name === 'set_anchor' || name === 'clear_anchor') {
+                const agentId = params.agent_id || 'default';
+                // 비동기로 브로드캐스트 (응답 지연 방지)
+                setImmediate(() => {
+                    broadcastAnchorMapUpdate(db, serverServices, anchorMapSubscribers, agentId).catch(error => {
+                        logger.error('Anchor Map broadcast failed', {
+                            error: error instanceof Error ? error.message : String(error)
+                        });
+                    });
+                });
+            }
+            return res.json({
+                result: actualResult,
+                tool: name,
+                timestamp: new Date().toISOString()
+            });
+        }
+        catch (error) {
+            logger.error('Tool execution failed', {
+                tool: name,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            return res.status(500).json({
+                error: 'Tool execution failed',
+                tool: name,
+                message: error instanceof Error ? error.message : 'Unknown error'
+            });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=tools.routes.js.map

package/dist/server/routes/tools.routes.js.map

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

package/dist/services/anchor/anchor-cache-service.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Anchor Cache Service
+ * 캐시 및 임베딩 관리 담당
+ * Phase 1.1: anchor-manager.ts 리팩토링
+ */
+import type Database from 'better-sqlite3';
+import type { MemoryEmbeddingService } from '../memory-embedding-service.js';
+import type { IAnchorCacheService, AnchorSlot } from './anchor-interfaces.js';
+/**
+ * Anchor Cache Service 구현
+ */
+export declare class AnchorCacheService implements IAnchorCacheService {
+    /**
+     * 메모리 캐시: agent_id별 슬롯 상태 관리
+     * Map<agent_id, {A: memory_id | null, B: memory_id | null, C: memory_id | null}>
+     */
+    private cache;
+    private db;
+    private embeddingService;
+    /**
+     * 생성자
+     */
+    constructor();
+    /**
+     * 데이터베이스 설정
+     */
+    setDatabase(db: Database.Database): void;
+    /**
+     * 임베딩 서비스 설정
+     */
+    setEmbeddingService(embeddingService: MemoryEmbeddingService): void;
+    /**
+     * 앵커 메모리의 임베딩 조회
+     * @param memoryId - 메모리 ID
+     * @returns 임베딩 벡터 및 제공자 정보, 없으면 null
+     */
+    getAnchorEmbedding(memoryId: string): Promise<{
+        embedding: number[];
+        provider: string;
+    } | null>;
+    /**
+     * 서버 재시작 시 DB에서 캐시 복원
+     * @param db - 데이터베이스 인스턴스
+     */
+    restoreCacheFromDB(db: Database.Database): Promise<void>;
+    /**
+     * 캐시 업데이트 헬퍼 메서드
+     * @param agentId - 에이전트 ID
+     * @param slot - 슬롯
+     * @param memoryId - 메모리 ID (null이면 제거)
+     */
+    updateCache(agentId: string, slot: AnchorSlot, memoryId: string | null): void;
+    /**
+     * 캐시에서 앵커 조회
+     * @param agentId - 에이전트 ID
+     * @param slot - 슬롯 (선택적)
+     * @returns 캐시된 앵커 정보
+     */
+    getCachedAnchor(agentId: string, slot?: AnchorSlot): {
+        A: string | null;
+        B: string | null;
+        C: string | null;
+    } | undefined;
+    /**
+     * 캐시에서 특정 슬롯의 메모리 ID 조회
+     * @param agentId - 에이전트 ID
+     * @param slot - 슬롯
+     * @returns 메모리 ID 또는 undefined
+     */
+    getCachedMemoryId(agentId: string, slot: AnchorSlot): string | null | undefined;
+    /**
+     * 캐시 삭제
+     * @param agentId - 에이전트 ID
+     */
+    deleteCache(agentId: string): void;
+}
+//# sourceMappingURL=anchor-cache-service.d.ts.map

package/dist/services/anchor/anchor-cache-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor-cache-service.d.ts","sourceRoot":"","sources":["../../../src/services/anchor/anchor-cache-service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAG9E;;GAEG;AACH,qBAAa,kBAAmB,YAAW,mBAAmB;IAC5D;;;OAGG;IACH,OAAO,CAAC,KAAK,CAAoF;IAEjG,OAAO,CAAC,EAAE,CAAkC;IAC5C,OAAO,CAAC,gBAAgB,CAAuC;IAE/D;;OAEG;;IAKH;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI;IAOxC;;OAEG;IACH,mBAAmB,CAAC,gBAAgB,EAAE,sBAAsB,GAAG,IAAI;IAOnE;;;;OAIG;IACG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAsErG;;;OAGG;IACG,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAoD9D;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAS7E;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG;QAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,SAAS;IAIzH;;;;;OAKG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS;IAK/E;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAGnC"}