Memory MCP Server

import type { LogEntry, LogLevel } from './types'; import type { Uid } from './schemas'; // UID 생성을 위한 카운터 (고유성 보장) let uidCounter = 0; /** * 현재 타임스탬프로 UID 생성 */ export function generateUid(): Uid { const now = new Date(); const year = now.getFullYear(); const month = (now.getMonth() + 1).toString().padStart(2, '0'); const day = now.getDate().toString().padStart(2, '0'); const hours = now.getHours().toString().padStart(2, '0'); const minutes = now.getMinutes().toString().padStart(2, '0'); const seconds = now.getSeconds().toString().padStart(2, '0'); // 밀리초 + 카운터로 고유성 보장 (999를 넘으면 리셋) const milliseconds = now.getMilliseconds(); uidCounter = (uidCounter + 1) % 1000; const uniqueId = (milliseconds * 1000 + uidCounter) .toString() .padStart(6, '0'); return `${year}${month}${day}T${hours}${minutes}${seconds}${uniqueId}Z` as Uid; } /** * 파일 경로를 정규화 */ export function normalizePath(filePath: string): string { return filePath.replace(/\\/g, '/').replace(/\/+/g, '/'); } /** * 파일 경로에서 확장자 제거 */ export function removeExtension(filePath: string): string { return filePath.replace(/\.[^/.]+$/, ''); } /** * Markdown 링크 파싱 ([[링크]], [텍스트](링크)) * @deprecated parseAllLinks() 사용을 권장합니다 */ export function parseMarkdownLinks(content: string): string[] { const wikiLinks = Array.from(content.matchAll(/\[\[([^\]]+)\]\]/g)) .map(match => match[1]?.trim()) .filter((link): link is string => Boolean(link)); const mdLinks = Array.from(content.matchAll(/\[([^\]]+)\]\(([^)]+)\)/g)) .map(match => match[2]?.trim()) .filter((link): link is string => Boolean(link)); return [...new Set([...wikiLinks, ...mdLinks])]; } /** * Wiki-style 링크만 파싱 - [[노트제목]] 또는 [[노트ID]] 형식 * * 지원 형식: * - [[노트제목]] * - [[노트ID]] * - [[링크|표시텍스트]] - 파이프 앞부분만 추출 * * @param content - 파싱할 텍스트 내용 * @returns 파싱된 Wiki 링크 배열 (중복 제거됨) */ export function parseWikiLinks(content: string): string[] { const wikiLinkRegex = /\[\[([^\]]+)\]\]/g; const links: string[] = []; let match: RegExpExecArray | null; while ((match = wikiLinkRegex.exec(content)) !== null) { const linkText = match[1]?.trim(); if (!linkText) continue; // [[링크|표시텍스트]] 형식 처리 - 파이프 앞부분만 추출 const pipeIndex = linkText.indexOf('|'); const actualLink = pipeIndex > -1 ? linkText.substring(0, pipeIndex).trim() : linkText; // 빈 링크 무시 if (actualLink) { links.push(actualLink); } } // 중복 제거 return Array.from(new Set(links)); } /** * 표준 Markdown 링크만 파싱 - [텍스트](url) 형식 * * @param content - 파싱할 텍스트 내용 * @returns 파싱된 Markdown 링크 배열 (중복 제거됨) */ export function parseStandardMarkdownLinks(content: string): string[] { const links = Array.from(content.matchAll(/\[([^\]]+)\]\(([^)]+)\)/g)) .map(match => match[2]?.trim()) .filter((link): link is string => Boolean(link)); return Array.from(new Set(links)); } /** * 모든 링크 파싱 (Wiki + Markdown) * * @param content - 파싱할 텍스트 내용 * @returns 링크 타입별로 분류된 결과 */ export function parseAllLinks(content: string): { wiki: string[]; markdown: string[]; all: string[]; } { const wikiLinks = parseWikiLinks(content); const markdownLinks = parseStandardMarkdownLinks(content); return { wiki: wikiLinks, markdown: markdownLinks, all: Array.from(new Set([...wikiLinks, ...markdownLinks])), }; } /** * 텍스트를 스니펫으로 변환 (검색 결과용) */ export function createSnippet( content: string, query: string, maxLength: number = 200 ): string { const queryRegex = new RegExp(query, 'gi'); const match = content.match(queryRegex); if (!match) { return ( content.slice(0, maxLength) + (content.length > maxLength ? '...' : '') ); } const matchIndex = content.search(queryRegex); const start = Math.max(0, matchIndex - maxLength / 2); const end = Math.min(content.length, start + maxLength); let snippet = content.slice(start, end); if (start > 0) snippet = '...' + snippet; if (end < content.length) snippet = snippet + '...'; return snippet; } /** * 민감정보 마스킹 (이메일, 전화번호 등) */ export function maskSensitiveInfo(text: string): string { return ( text // 이메일 마스킹 .replace( /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b/g, '***@***.***' ) // 전화번호 마스킹 (한국 형식) .replace(/\b\d{2,3}-\d{3,4}-\d{4}\b/g, '***-****-****') // 신용카드 번호 마스킹 .replace( /\b\d{4}[\s-]?\d{4}[\s-]?\d{4}[\s-]?\d{4}\b/g, '****-****-****-****' ) ); } /** * 구조적 로그 생성 */ export function createLogEntry( level: LogLevel, message: string, metadata?: Record<string, unknown>, component?: string, operation?: string ): LogEntry { return { timestamp: new Date().toISOString(), level, message, ...(metadata && { metadata }), ...(component && { component }), ...(operation && { operation }), }; } /** * 디바운스 함수 */ export function debounce<T extends (..._args: unknown[]) => unknown>( func: T, wait: number ): (..._args: Parameters<T>) => void { let timeoutId: NodeJS.Timeout | undefined; return (...funcArgs: Parameters<T>) => { clearTimeout(timeoutId); timeoutId = setTimeout(() => func(...funcArgs), wait); }; } /** * 파일 크기를 사람이 읽기 쉬운 형태로 변환 */ export function formatFileSize(bytes: number): string { const units = ['B', 'KB', 'MB', 'GB']; let size = bytes; let unitIndex = 0; while (size >= 1024 && unitIndex < units.length - 1) { size /= 1024; unitIndex++; } return `${size.toFixed(1)} ${units[unitIndex]}`; } /** * 간단한 로거 클래스 * * 중요: MCP 프로토콜 호환성을 위해 모든 로그는 stderr로 출력됩니다. * stdout은 JSON-RPC 메시지 전용으로 예약되어 있습니다. */ class Logger { private level: LogLevel = 'info'; setLevel(level: LogLevel): void { this.level = level; } private shouldLog(level: LogLevel): boolean { const levels: Record<LogLevel, number> = { debug: 0, info: 1, warn: 2, error: 3, }; return levels[level] >= levels[this.level]; } debug(message: string, ...args: unknown[]): void { if (this.shouldLog('debug')) { // MCP 호환: stderr로 출력 (stdout은 JSON-RPC 전용) console.error(`[DEBUG] ${message}`, ...args); } } info(message: string, ...args: unknown[]): void { if (this.shouldLog('info')) { // MCP 호환: stderr로 출력 (stdout은 JSON-RPC 전용) console.error(`[INFO] ${message}`, ...args); } } warn(message: string, ...args: unknown[]): void { if (this.shouldLog('warn')) { console.warn(`[WARN] ${message}`, ...args); } } error(message: string, ...args: unknown[]): void { if (this.shouldLog('error')) { console.error(`[ERROR] ${message}`, ...args); } } } /** * 글로벌 로거 인스턴스 */ export const logger = new Logger(); /** * 백링크 문맥 추출 * * @param content - 노트 내용 * @param linkText - 검색할 링크 텍스트 (노트 제목 또는 UID) * @param contextLines - 앞뒤로 포함할 라인 수 (기본: 2) * @returns 문맥 스니펫 배열 */ export function extractBacklinkContext( content: string, linkText: string, contextLines: number = 2 ): Array<{ snippet: string; lineNumber: number; linkType: 'wiki' | 'markdown' }> { const lines = content.split('\n'); const results: Array<{ snippet: string; lineNumber: number; linkType: 'wiki' | 'markdown' }> = []; // Wiki 링크 패턴: [[linkText]] 또는 [[linkText|display]] const wikiPattern = new RegExp(`\\[\\[(?:${escapeRegex(linkText)}(?:\\|[^\\]]+)?)\\]\\]`, 'gi'); // Markdown 링크 패턴: [text](linkText) const mdPattern = new RegExp(`\\[[^\\]]+\\]\\(${escapeRegex(linkText)}\\)`, 'gi'); lines.forEach((line, index) => { const lineNumber = index + 1; let foundMatch = false; // Check for Wiki links if (wikiPattern.test(line)) { foundMatch = true; const start = Math.max(0, index - contextLines); const end = Math.min(lines.length, index + contextLines + 1); const snippet = lines.slice(start, end).join('\n'); results.push({ snippet: snippet.trim(), lineNumber, linkType: 'wiki' }); } // Reset regex lastIndex wikiPattern.lastIndex = 0; // Check for Markdown links if (mdPattern.test(line) && !foundMatch) { const start = Math.max(0, index - contextLines); const end = Math.min(lines.length, index + contextLines + 1); const snippet = lines.slice(start, end).join('\n'); results.push({ snippet: snippet.trim(), lineNumber, linkType: 'markdown' }); } // Reset regex lastIndex mdPattern.lastIndex = 0; }); return results; } /** * 정규식 특수문자 이스케이프 */ function escapeRegex(str: string): string { return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); }