memento-mcp-server 0.1.0

package/install.sh

@@ -0,0 +1,191 @@
+#!/bin/bash
+
+# Memento MCP Server 자동 설치 스크립트
+# 사용법: curl -sSL https://raw.githubusercontent.com/jee1/memento/main/install.sh | bash
+
+set -e
+
+# 색상 정의
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+MAGENTA='\033[0;35m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+# 로그 함수들
+log() {
+    echo -e "${CYAN}🚀 $1${NC}"
+}
+
+log_success() {
+    echo -e "${GREEN}✅ $1${NC}"
+}
+
+log_warning() {
+    echo -e "${YELLOW}⚠️  $1${NC}"
+}
+
+log_error() {
+    echo -e "${RED}❌ $1${NC}"
+}
+
+# 설치 모드 선택
+select_install_mode() {
+    echo -e "${MAGENTA}Memento MCP Server 설치 모드를 선택하세요:${NC}"
+    echo "1) npx 방식 (빠른 설치, 개발용)"
+    echo "2) Docker 방식 (안정적, 프로덕션용)"
+    echo "3) 소스코드 방식 (개발자용)"
+    echo "4) 종료"
+    
+    read -p "선택 (1-4): " choice
+    
+    case $choice in
+        1) install_npx ;;
+        2) install_docker ;;
+        3) install_source ;;
+        4) exit 0 ;;
+        *) log_error "잘못된 선택입니다."; exit 1 ;;
+    esac
+}
+
+# npx 방식 설치
+install_npx() {
+    log "npx 방식으로 설치를 시작합니다..."
+    
+    # Node.js 버전 확인
+    if ! command -v node &> /dev/null; then
+        log_error "Node.js가 설치되어 있지 않습니다."
+        log "Node.js 20 이상을 설치해주세요: https://nodejs.org/"
+        exit 1
+    fi
+    
+    NODE_VERSION=$(node -v | cut -d'v' -f2 | cut -d'.' -f1)
+    if [ "$NODE_VERSION" -lt 20 ]; then
+        log_error "Node.js 20 이상이 필요합니다. 현재 버전: $(node -v)"
+        exit 1
+    fi
+    
+    log_success "Node.js 버전 확인 완료: $(node -v)"
+    
+    # npx로 서버 실행
+    log "Memento MCP Server를 시작합니다..."
+    npx memento-mcp-server@latest setup
+    npx memento-mcp-server@latest dev
+    
+    log_success "npx 방식 설치 완료!"
+    log "서버가 http://localhost:8080 에서 실행 중입니다."
+}
+
+# Docker 방식 설치
+install_docker() {
+    log "Docker 방식으로 설치를 시작합니다..."
+    
+    # Docker 확인
+    if ! command -v docker &> /dev/null; then
+        log_error "Docker가 설치되어 있지 않습니다."
+        log "Docker를 설치해주세요: https://docs.docker.com/get-docker/"
+        exit 1
+    fi
+    
+    # Docker Compose 확인
+    if ! command -v docker-compose &> /dev/null && ! docker compose version &> /dev/null; then
+        log_error "Docker Compose가 설치되어 있지 않습니다."
+        exit 1
+    fi
+    
+    log_success "Docker 환경 확인 완료"
+    
+    # 프로젝트 클론
+    if [ ! -d "memento" ]; then
+        log "프로젝트를 클론합니다..."
+        git clone https://github.com/jee1/memento.git
+        cd memento
+    else
+        log "기존 프로젝트 디렉토리를 사용합니다..."
+        cd memento
+        git pull
+    fi
+    
+    # 환경 변수 설정
+    if [ ! -f ".env" ]; then
+        log "환경 변수 파일을 생성합니다..."
+        cp env.example .env
+        log_warning ".env 파일을 편집하여 API 키를 설정하세요."
+    fi
+    
+    # Docker Compose 실행
+    log "Docker 컨테이너를 시작합니다..."
+    docker-compose up -d
+    
+    log_success "Docker 방식 설치 완료!"
+    log "서버가 http://localhost:8080 에서 실행 중입니다."
+    log "로그 확인: docker-compose logs -f"
+}
+
+# 소스코드 방식 설치
+install_source() {
+    log "소스코드 방식으로 설치를 시작합니다..."
+    
+    # Node.js 버전 확인
+    if ! command -v node &> /dev/null; then
+        log_error "Node.js가 설치되어 있지 않습니다."
+        exit 1
+    fi
+    
+    # 프로젝트 클론
+    if [ ! -d "memento" ]; then
+        log "프로젝트를 클론합니다..."
+        git clone https://github.com/jee1/memento.git
+        cd memento
+    else
+        log "기존 프로젝트 디렉토리를 사용합니다..."
+        cd memento
+        git pull
+    fi
+    
+    # 의존성 설치
+    log "의존성을 설치합니다..."
+    npm install
+    
+    # 자동 설정 실행
+    log "자동 설정을 실행합니다..."
+    npm run setup
+    
+    # 개발 서버 시작
+    log "개발 서버를 시작합니다..."
+    npm run dev
+    
+    log_success "소스코드 방식 설치 완료!"
+    log "서버가 http://localhost:8080 에서 실행 중입니다."
+}
+
+# 메인 함수
+main() {
+    echo -e "${MAGENTA}"
+    echo "╔══════════════════════════════════════════════════════════════╗"
+    echo "║                    Memento MCP Server                       ║"
+    echo "║              AI Agent 기억 보조 서버 자동 설치                ║"
+    echo "╚══════════════════════════════════════════════════════════════╝"
+    echo -e "${NC}"
+    
+    log "환경을 확인합니다..."
+    
+    # OS 확인
+    OS="unknown"
+    if [[ "$OSTYPE" == "linux-gnu"* ]]; then
+        OS="linux"
+    elif [[ "$OSTYPE" == "darwin"* ]]; then
+        OS="macos"
+    elif [[ "$OSTYPE" == "cygwin" ]] || [[ "$OSTYPE" == "msys" ]] || [[ "$OSTYPE" == "win32" ]]; then
+        OS="windows"
+    fi
+    
+    log_success "운영체제: $OS"
+    
+    select_install_mode
+}
+
+# 스크립트 실행
+main "$@"

package/mcp-http-client.js

@@ -0,0 +1,218 @@
+#!/usr/bin/env node
+
+/**
+ * Memento MCP Simple Client
+ * HTTP 서버와 통신하는 간단한 MCP 클라이언트
+ */
+
+import { spawn } from 'child_process';
+import fetch from 'node-fetch';
+
+const serverUrl = process.env.MEMENTO_SERVER_URL || 'http://localhost:9001';
+const apiKey = process.env.MEMENTO_API_KEY || 'default-key';
+
+// HTTP 서버와 통신하는 함수
+async function callHttpTool(toolName, args) {
+  try {
+    const response = await fetch(`${serverUrl}/tools/${toolName}`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${apiKey}`,
+        'User-Agent': 'Memento-MCP-Client/1.0.0'
+      },
+      body: JSON.stringify(args)
+    });
+
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+
+    const result = await response.json();
+    return result.result || result;
+  } catch (error) {
+    throw new Error(`Tool execution failed: ${error.message}`);
+  }
+}
+
+async function getHttpTools() {
+  try {
+    const response = await fetch(`${serverUrl}/tools`, {
+      headers: {
+        'Authorization': `Bearer ${apiKey}`,
+        'User-Agent': 'Memento-MCP-Client/1.0.0'
+      }
+    });
+
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+
+    const result = await response.json();
+    return result.tools || [];
+  } catch (error) {
+    throw new Error(`Failed to get tools: ${error.message}`);
+  }
+}
+
+// MCP 프로토콜 처리
+let requestId = 0;
+
+function sendResponse(id, result, error = null) {
+  const response = {
+    jsonrpc: '2.0',
+    id: id
+  };
+  
+  if (error) {
+    response.error = error;
+  } else {
+    response.result = result;
+  }
+  
+  process.stderr.write(`📤 응답 전송: ${JSON.stringify(response).substring(0, 100)}...\n`);
+  console.log(JSON.stringify(response));
+}
+
+async function handleRequest(request) {
+  const { method, params, id } = request;
+  
+  process.stderr.write(`📨 요청 수신: ${method} (ID: ${id})\n`);
+  
+  try {
+    if (method === 'initialize') {
+      process.stderr.write(`🚀 initialize 요청 처리 중...\n`);
+      sendResponse(id, {
+        protocolVersion: '2024-11-05',
+        capabilities: {
+          tools: {}
+        },
+        serverInfo: {
+          name: 'memento-http-client',
+          version: '1.0.0'
+        }
+      });
+    } else if (method === 'notifications/initialized') {
+      // This is a notification. Do not send a response.
+      process.stderr.write(`🔔 initialized 알림 수신, 무시합니다.\n`);
+    } else if (method === 'tools/list') {
+      process.stderr.write(`📋 tools/list 요청 처리 중...\n`);
+      const tools = await getHttpTools();
+      process.stderr.write(`🔧 도구 개수: ${tools.length}\n`);
+      sendResponse(id, { tools });
+    } else if (method === 'tools/call') {
+      const { name, arguments: args } = params;
+      process.stderr.write(`🔧 도구 실행: ${name}\n`);
+      const result = await callHttpTool(name, args);
+      
+      sendResponse(id, {
+        content: [
+          {
+            type: 'text',
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      });
+    } else {
+      // Unknown method
+      if (id !== undefined && id !== null) {
+        // Only send an error if it was a request (i.e., it had an ID).
+        process.stderr.write(`❌ 알 수 없는 메서드: ${method}\n`);
+        sendResponse(id, null, {
+          code: -32601,
+          message: 'Method not found'
+        });
+      } else {
+        // It's an unknown notification, ignore it silently.
+        process.stderr.write(`🔔 알 수 없는 알림 수신, 무시합니다: ${method}\n`);
+      }
+    }
+  } catch (error) {
+    process.stderr.write(`❌ 요청 처리 실패: ${error.message}\n`);
+    if (id !== undefined && id !== null) {
+      sendResponse(id, null, {
+        code: -32603,
+        message: 'Internal error',
+        data: error.message
+      });
+    }
+  }
+}
+
+// 서버 상태 확인
+async function checkServerHealth() {
+  try {
+    const response = await fetch(`${serverUrl}/health`);
+    if (response.ok) {
+      const health = await response.json();
+      process.stderr.write(`✅ 서버 연결 확인: ${health.status}\n`);
+      return true;
+    }
+  } catch (error) {
+    process.stderr.write(`❌ 서버 연결 실패: ${error.message}\n`);
+  }
+  return false;
+}
+
+// 메인 처리
+async function main() {
+  process.stderr.write(`🚀 Memento MCP 클라이언트 시작\n`);
+  process.stderr.write(`🔗 서버 URL: ${serverUrl}\n`);
+  
+  // 서버 상태 확인
+  const isHealthy = await checkServerHealth();
+  if (!isHealthy) {
+    process.exit(1);
+  }
+  
+  process.stderr.write(`📡 stdin 대기 중...\n`);
+  
+  // stdin에서 JSON-RPC 요청 읽기
+  let buffer = '';
+  
+  process.stdin.on('data', async (chunk) => {
+    const data = chunk.toString();
+    buffer += data;
+    
+    // Process complete JSON objects
+    const lines = buffer.split('\n');
+    buffer = lines.pop() || ''; // Keep the last incomplete line in the buffer
+    
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (trimmed) {
+        try {
+          const request = JSON.parse(trimmed);
+          await handleRequest(request);
+        } catch (error) {
+          process.stderr.write(`❌ JSON 파싱 오류: ${error.message} on line: ${trimmed}\n`);
+        }
+      }
+    }
+  });
+  
+  process.stdin.on('end', () => {
+    process.stderr.write(`📡 stdin 종료\n`);
+    process.exit(0);
+  });
+  
+  process.stdin.on('error', (error) => {
+    process.stderr.write(`❌ stdin 오류: ${error.message}\n`);
+    process.exit(1);
+  });
+}
+
+// 프로세스 종료 시 정리
+process.on('SIGINT', () => {
+  process.exit(0);
+});
+
+process.on('SIGTERM', () => {
+  process.exit(0);
+});
+
+// 클라이언트 시작
+main().catch(error => {
+  process.stderr.write(`❌ 클라이언트 시작 실패: ${error.message}\n`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,125 @@
+{
+  "name": "memento-mcp-server",
+  "version": "0.1.0",
+  "description": "AI Agent 기억 보조 MCP 서버 - 사람의 기억 구조를 모사한 스토리지+검색+요약+망각 메커니즘",
+  "main": "dist/server.js",
+  "type": "module",
+  "bin": {
+    "memento-mcp": "./dist/server/index.js",
+    "memento-dev": "./dist/server/http-server.js",
+    "memento-setup": "./scripts/auto-setup.js"
+  },
+  "scripts": {
+    "dev": "tsx watch src/server/index.ts",
+    "dev:http": "tsx watch src/server/http-server.ts",
+    "dev:http-v2": "tsx watch src/server/http-server-v2.ts",
+    "build": "tsc && npm run copy:assets",
+    "copy:assets": "node src/scripts/copy-assets.js",
+    "start": "node dist/server/index.js",
+    "start:http": "node dist/server/http-server.js",
+    "start:http-v2": "node dist/server/http-server-v2.js",
+    "test": "vitest",
+    "lint": "eslint src/**/*.ts",
+    "type-check": "tsc --noEmit",
+    "db:init": "tsx src/database/init.ts",
+    "db:migrate": "tsx src/database/migrate.ts",
+    "test:client": "tsx src/test/test-client.ts",
+    "test:http-v2": "tsx src/test/test-http-server-v2.ts",
+    "test:search": "tsx src/test/test-search.ts",
+    "test:embedding": "tsx src/test/test-embedding.ts",
+    "test:lightweight-embedding": "tsx src/test/test-lightweight-embedding.ts",
+    "test:gemini-embedding": "tsx src/test/test-gemini-embedding.ts",
+    "test:forgetting": "tsx src/test/test-forgetting.ts",
+    "test:performance": "tsx src/test/performance-benchmark.ts",
+    "test:monitoring": "tsx src/test/test-performance-monitoring.ts",
+    "test:error-logging": "tsx src/test/test-error-logging.ts",
+    "test:performance-alerts": "tsx src/test/test-performance-alerts.ts",
+    "test:batch-scheduler": "tsx src/test/test-batch-scheduler.ts",
+    "test:vector-search": "tsx src/test/test-vector-search-engine.ts",
+    "test:memory-injection": "tsx src/test/test-memory-injection-prompt.ts",
+    "test:embedding-benchmark": "vitest src/test/embedding-performance-benchmark.spec.ts",
+    "test:embedding-integration": "vitest src/test/embedding-integration-test.spec.ts",
+    "benchmark:embedding": "vitest src/test/embedding-performance-benchmark.spec.ts --reporter=verbose",
+    "test:all-embedding": "vitest src/test/embedding-*.spec.ts --reporter=verbose",
+    "migrate:embedding": "node scripts/migrate-embedding-data.js migrate",
+    "migrate:embedding:analyze": "node scripts/migrate-embedding-data.js analyze",
+    "migrate:embedding:rollback": "node scripts/migrate-embedding-data.js rollback",
+    "test:docker": "node test-docker.js",
+    "setup": "node scripts/auto-setup.js",
+    "postinstall": "node scripts/auto-setup.js",
+    "quick-start": "npm install && npm run setup && npm run dev",
+    "backup:embeddings": "node scripts/backup-embeddings.js",
+    "regenerate:embeddings": "node scripts/regenerate-embeddings.js",
+    "debug:embeddings": "node scripts/debug-embeddings.js",
+    "fix:vector-dimensions": "node scripts/fix-vector-dimensions.js",
+    "fix:vectors": "npm run backup:embeddings && npm run regenerate:embeddings",
+    "docker:build": "docker-compose build",
+    "docker:up": "docker-compose up -d",
+    "docker:down": "docker-compose down",
+    "docker:logs": "docker-compose logs -f",
+    "docker:dev": "docker-compose -f docker-compose.dev.yml up -d",
+    "docker:prod": "docker-compose -f docker-compose.prod.yml up -d",
+    "docker:dev:logs": "docker-compose -f docker-compose.dev.yml logs -f",
+    "docker:prod:logs": "docker-compose -f docker-compose.prod.yml logs -f",
+    "build:client": "cd packages/mcp-client && npm run build",
+    "dev:client": "cd packages/mcp-client && npm run dev",
+    "clean:client": "cd packages/mcp-client && npm run clean",
+    "publish:client": "cd packages/mcp-client && npm publish"
+  },
+  "keywords": [
+    "mcp",
+    "memory",
+    "ai",
+    "agent",
+    "sqlite",
+    "vector-search",
+    "typescript"
+  ],
+  "author": "Memento Team",
+  "license": "MIT",
+  "dependencies": {
+    "@google/genai": "^1.21.0",
+    "@google/generative-ai": "^0.24.1",
+    "@memento/client": "file:packages/mcp-client",
+    "@modelcontextprotocol/sdk": "^1.18.2",
+    "@xenova/transformers": "^2.17.2",
+    "axios": "^1.12.2",
+    "better-sqlite3": "^12.4.1",
+    "cors": "^2.8.5",
+    "dotenv": "^16.3.1",
+    "express": "^5.1.0",
+    "node-fetch": "^3.3.2",
+    "openai": "^4.20.1",
+    "sqlite-vec": "^0.1.6",
+    "uuid": "^9.0.1",
+    "ws": "^8.18.3",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.3",
+    "@types/node": "^20.10.0",
+    "@types/uuid": "^9.0.7",
+    "@types/ws": "^8.18.1",
+    "@typescript-eslint/eslint-plugin": "^6.13.0",
+    "@typescript-eslint/parser": "^6.13.0",
+    "@vitest/coverage-v8": "^1.0.0",
+    "eslint": "^8.54.0",
+    "eventsource": "^4.0.0",
+    "tsx": "^4.6.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/your-org/memento.git"
+  },
+  "bugs": {
+    "url": "https://github.com/your-org/memento/issues"
+  },
+  "homepage": "https://github.com/your-org/memento#readme"
+}