aiexecode 1.0.88 → 1.0.90

package/mcp-agent-lib/example/06-resources-and-prompts.js

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+
+/**
+ * 리소스와 프롬프트 사용 예제
+ *
+ * MCP 서버의 도구(Tools) 외에도 리소스(Resources)와 프롬프트(Prompts)를
+ * 사용하는 방법을 보여줍니다.
+ *
+ * - Resources: 파일, 데이터, 문서 등을 읽을 수 있는 URI 기반 리소스
+ * - Prompts: 미리 정의된 프롬프트 템플릿
+ */
+
+import { MCPAgentClient } from '../index.js';
+
+async function main() {
+  const client = new MCPAgentClient({
+    logLevel: 'info',
+    enableConsoleDebug: true
+  });
+
+  try {
+    await client.initialize({
+      mcpServers: {
+        'content-server': {
+          type: 'stdio',
+          command: 'node',
+          args: ['content-server.js']
+        }
+      }
+    });
+
+    // ========================================
+    // 1. 리소스(Resources) 사용하기
+    // ========================================
+
+    console.log('📄 리소스 목록 조회...\n');
+
+    // 모든 서버의 리소스 목록
+    const allResources = client.getAvailableResources();
+    console.log(`총 ${allResources.length}개의 리소스 발견:`);
+    allResources.forEach(resource => {
+      console.log(`\n- ${resource.name}`);
+      console.log(`  서버: ${resource.serverName}`);
+      console.log(`  URI: ${resource.uri}`);
+      if (resource.description) {
+        console.log(`  설명: ${resource.description}`);
+      }
+      if (resource.mimeType) {
+        console.log(`  타입: ${resource.mimeType}`);
+      }
+    });
+
+    // 리소스 읽기 - 방법 1: URI로 자동 검색
+    if (allResources.length > 0) {
+      console.log('\n📖 리소스 읽기 (자동 서버 검색)...');
+      const resourceUri = allResources[0].uri;
+
+      try {
+        const content = await client.readResource(resourceUri);
+        console.log(`\n✅ ${resourceUri} 내용:`);
+        console.log(`타입: ${content.mimeType}`);
+        console.log(`데이터: ${content.data?.substring(0, 200)}...`);
+      } catch (error) {
+        console.error(`❌ 리소스 읽기 실패: ${error.message}`);
+      }
+    }
+
+    // 리소스 읽기 - 방법 2: 특정 서버에서 읽기
+    if (allResources.length > 0) {
+      console.log('\n📖 리소스 읽기 (특정 서버 지정)...');
+      const resource = allResources[0];
+
+      try {
+        const content = await client.readResourceFromServer(
+          resource.serverName,
+          resource.uri
+        );
+        console.log(`✅ 읽기 성공: ${content.uri}`);
+      } catch (error) {
+        console.error(`❌ 실패: ${error.message}`);
+      }
+    }
+
+    // ========================================
+    // 2. 프롬프트(Prompts) 사용하기
+    // ========================================
+
+    console.log('\n\n💬 프롬프트 목록 조회...\n');
+
+    // 모든 서버의 프롬프트 목록
+    const allPrompts = client.getAvailablePrompts();
+    console.log(`총 ${allPrompts.length}개의 프롬프트 발견:`);
+    allPrompts.forEach(prompt => {
+      console.log(`\n- ${prompt.name}`);
+      console.log(`  서버: ${prompt.serverName}`);
+      if (prompt.description) {
+        console.log(`  설명: ${prompt.description}`);
+      }
+      if (prompt.arguments && prompt.arguments.length > 0) {
+        console.log(`  인자:`);
+        prompt.arguments.forEach(arg => {
+          console.log(`    - ${arg.name}: ${arg.description || '(설명 없음)'}`);
+          console.log(`      필수: ${arg.required ? '예' : '아니오'}`);
+        });
+      }
+    });
+
+    // 프롬프트 실행 - 방법 1: 이름으로 자동 검색
+    if (allPrompts.length > 0) {
+      console.log('\n🎯 프롬프트 실행 (자동 서버 검색)...');
+      const promptName = allPrompts[0].name;
+
+      try {
+        const result = await client.executePrompt(promptName, {
+          // 프롬프트에 필요한 인자 전달
+          // 예: { topic: 'AI', style: 'formal' }
+        });
+        console.log(`\n✅ ${promptName} 실행 결과:`);
+        console.log(result);
+      } catch (error) {
+        console.error(`❌ 프롬프트 실행 실패: ${error.message}`);
+      }
+    }
+
+    // 프롬프트 실행 - 방법 2: 특정 서버에서 실행
+    if (allPrompts.length > 0) {
+      console.log('\n🎯 프롬프트 실행 (특정 서버 지정)...');
+      const prompt = allPrompts[0];
+
+      try {
+        const result = await client.getPrompt(
+          prompt.serverName,
+          prompt.name,
+          {
+            // 프롬프트 인자
+            customParam: 'value'
+          }
+        );
+        console.log(`✅ 실행 성공`);
+        console.log(result);
+      } catch (error) {
+        console.error(`❌ 실패: ${error.message}`);
+      }
+    }
+
+    // ========================================
+    // 3. 통합 정보 조회
+    // ========================================
+
+    console.log('\n\n📊 서버별 기능 요약:\n');
+    const status = client.getStatus();
+
+    for (const [serverName, serverStatus] of Object.entries(status.servers)) {
+      console.log(`${serverName}:`);
+      console.log(`  상태: ${serverStatus.status}`);
+      console.log(`  도구: ${serverStatus.toolCount}개`);
+
+      // 해당 서버의 리소스 수
+      const serverResources = allResources.filter(r => r.serverName === serverName);
+      console.log(`  리소스: ${serverResources.length}개`);
+
+      // 해당 서버의 프롬프트 수
+      const serverPrompts = allPrompts.filter(p => p.serverName === serverName);
+      console.log(`  프롬프트: ${serverPrompts.length}개`);
+    }
+
+  } catch (error) {
+    console.error('❌ 오류:', error.message);
+  } finally {
+    await client.disconnect();
+  }
+}
+
+main().catch(console.error);

package/mcp-agent-lib/example/07-advanced-configuration.js

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+
+/**
+ * 고급 설정 예제
+ *
+ * MCP Agent Client의 다양한 설정 옵션을 활용하는 방법입니다.
+ * - 환경변수를 통한 설정
+ * - 보안 설정
+ * - 성능 튜닝
+ * - 로깅 설정
+ */
+
+import { MCPAgentClient } from '../index.js';
+
+async function main() {
+  // ========================================
+  // 1. 전체 설정 옵션 예시
+  // ========================================
+
+  const client = new MCPAgentClient({
+    // === 기본 설정 ===
+    autoConnect: true,              // 초기화 시 자동 연결 (기본값: true)
+    logLevel: 'debug',              // 로그 레벨: debug, info, warn, error, silent
+    enableConsoleDebug: true,       // 콘솔 출력 활성화
+    enableLogging: true,            // 로깅 활성화
+
+    // === 타임아웃 설정 ===
+    timeout: 30000,                 // 기본 타임아웃 (30초)
+    serverReadyTimeout: 10000,      // 서버 준비 대기 타임아웃 (10초)
+    processKillTimeout: 5000,       // 프로세스 종료 대기 시간 (5초)
+
+    // === 재시도 설정 ===
+    retries: 3,                     // 도구 실행 실패 시 재시도 횟수
+    retryDelay: 1000,               // 첫 재시도 지연 (1초)
+    maxRetryDelay: 30000,           // 최대 재시도 지연 (30초)
+    serverReadyRetries: 5,          // 서버 준비 확인 재시도 횟수
+
+    // === 보안 설정 ===
+    allowedCommands: ['node', 'python', 'python3', 'npx', 'deno'],
+    dangerousChars: ['&', ';', '|', '`', '$', '>', '<', '*', '?'],
+
+    // === 메모리 및 크기 제한 ===
+    maxResponseSize: 1024 * 1024,   // 최대 응답 크기 (1MB)
+    maxJsonSize: 10 * 1024 * 1024,  // 최대 JSON 크기 (10MB)
+    maxLogLength: 100,              // 로그 문자열 최대 길이
+    maxRequestIds: 10000,           // 최대 요청 ID 수
+
+    // === HTTP 전송 설정 ===
+    httpMaxRetries: 3,              // HTTP 연결 최대 재시도
+    httpInitialDelay: 1000,         // HTTP 첫 재시도 지연
+    httpMaxDelay: 10000,            // HTTP 최대 재시도 지연
+    httpGrowthFactor: 1.5,          // HTTP 재시도 지연 증가율
+
+    // === 메모리 관리 ===
+    memoryCleanupEnabled: true,     // 메모리 자동 정리 활성화
+
+    // === MCP 프로토콜 설정 ===
+    clientInfo: {
+      name: 'my-custom-client',
+      version: '1.0.0'
+    },
+    clientCapabilities: {
+      roots: { listChanged: true },
+      sampling: {},
+      experimental: {}
+    }
+  });
+
+  try {
+    // ========================================
+    // 2. 환경변수를 통한 설정
+    // ========================================
+
+    // 환경변수 설정 예시 (실제로는 shell에서 설정)
+    // export MCP_LOG_LEVEL=debug
+    // export MCP_TIMEOUT=60000
+    // export MCP_RETRIES=5
+    // export MCP_MAX_RESPONSE_SIZE=2097152
+
+    console.log('📋 현재 설정:');
+    console.log(`  로그 레벨: ${client.options.logLevel}`);
+    console.log(`  타임아웃: ${client.options.timeout}ms`);
+    console.log(`  재시도: ${client.options.retries}회`);
+    console.log(`  최대 응답 크기: ${client.options.maxResponseSize} bytes`);
+
+    // ========================================
+    // 3. 보안 강화 설정
+    // ========================================
+
+    await client.initialize({
+      mcpServers: {
+        'secure-server': {
+          type: 'stdio',
+          command: 'node',  // allowedCommands에 있는 명령어만 허용
+          args: ['server.js'], // dangerousChars가 없는 안전한 인자
+          env: {
+            // 환경변수는 문자열 key-value만 허용
+            NODE_ENV: 'production',
+            SAFE_MODE: 'true'
+          }
+        }
+      }
+    });
+
+    // ========================================
+    // 4. 커스텀 로깅
+    // ========================================
+
+    // 클라이언트의 보안 로그 시스템 사용
+    client.secureLog('info', '커스텀 정보 로그', {
+      customData: 'value',
+      sensitiveToken: 'will-be-redacted'  // 자동으로 [REDACTED] 처리됨
+    });
+
+    client.secureLog('warn', '경고 메시지', {
+      issue: 'something to check'
+    });
+
+    client.secureLog('error', '에러 발생', {
+      errorCode: 500,
+      errorMessage: 'Something went wrong'
+    });
+
+    // ========================================
+    // 5. 메모리 관리
+    // ========================================
+
+    console.log('\n🧹 메모리 정리 실행...');
+    client.performMemoryCleanup();
+    console.log('✅ 정리 완료');
+
+    // ========================================
+    // 6. 서버 기능(Capabilities) 조회
+    // ========================================
+
+    console.log('\n📋 서버 기능 조회...');
+
+    // 모든 서버의 기능
+    const allCapabilities = client.getServerCapabilities();
+    console.log('모든 서버의 기능:', allCapabilities);
+
+    // 특정 서버의 기능
+    const serverCaps = client.getServerCapabilities('secure-server');
+    console.log('secure-server의 기능:', serverCaps);
+
+    // ========================================
+    // 7. 이벤트 모니터링
+    // ========================================
+
+    // 서버 상태 변경 모니터링
+    client.on('serverStatusChange', ({ serverName, status, previousStatus }) => {
+      console.log(`\n📡 [이벤트] ${serverName}:`);
+      console.log(`   ${previousStatus} → ${status}`);
+    });
+
+    // 서버 에러 모니터링
+    client.on('serverError', (serverName, error) => {
+      console.error(`\n⚠️ [이벤트] 서버 에러 [${serverName}]:`, error);
+    });
+
+    // 서버 연결 해제 모니터링
+    client.on('serverDisconnected', (serverName) => {
+      console.warn(`\n🔌 [이벤트] 서버 연결 해제: ${serverName}`);
+    });
+
+    // ========================================
+    // 8. 안전한 JSON 처리
+    // ========================================
+
+    // 순환 참조가 있는 객체도 안전하게 직렬화
+    const circularObj = { name: 'test' };
+    circularObj.self = circularObj;
+
+    const safeJson = client.safeJsonStringify(circularObj);
+    console.log('\n🔒 안전한 JSON 직렬화:', safeJson);
+
+    // 보안 위협이 있는 JSON도 안전하게 파싱
+    const dangerousJson = '{"__proto__": {"polluted": true}}';
+    const safeParsed = client.safeJsonParse(dangerousJson);
+    console.log('🔒 안전한 JSON 파싱:', safeParsed);
+
+  } catch (error) {
+    console.error('❌ 오류:', error.message);
+  } finally {
+    // cleanup()은 disconnect()와 메모리 정리를 모두 수행
+    await client.cleanup();
+    console.log('\n✅ 모든 리소스 정리 완료');
+  }
+}
+
+main().catch(console.error);

package/mcp-agent-lib/example/08-real-world-chatbot.js

@@ -0,0 +1,331 @@
+#!/usr/bin/env node
+
+/**
+ * 실전 예제: AI 챗봇 구현
+ *
+ * MCP Agent Client를 사용하여 실제 AI 챗봇을 만드는 예제입니다.
+ * 여러 MCP 서버의 도구를 활용하여 파일 검색, 데이터 조회, 코드 실행 등을
+ * 자연어로 수행할 수 있습니다.
+ */
+
+import { MCPAgentClient } from '../index.js';
+import readline from 'readline';
+
+// ========================================
+// 챗봇 클래스
+// ========================================
+
+class MCPChatbot {
+  constructor() {
+    this.client = null;
+    this.conversationHistory = [];
+  }
+
+  async initialize() {
+    console.log('🤖 MCP Chatbot 초기화 중...\n');
+
+    this.client = new MCPAgentClient({
+      logLevel: 'warn',  // 챗봇 동작 중에는 경고만 표시
+      enableConsoleDebug: false,
+      timeout: 30000,
+      retries: 3
+    });
+
+    // 여러 기능을 제공하는 MCP 서버들에 연결
+    await this.client.initialize({
+      mcpServers: {
+        // 파일 시스템 도구
+        'filesystem': {
+          type: 'stdio',
+          command: 'npx',
+          args: ['-y', '@modelcontextprotocol/server-filesystem', '/tmp']
+        },
+
+        // GitHub 도구 (예시)
+        'github': {
+          type: 'stdio',
+          command: 'npx',
+          args: ['-y', '@modelcontextprotocol/server-github'],
+          env: {
+            GITHUB_TOKEN: process.env.GITHUB_TOKEN || ''
+          }
+        },
+
+        // 메모리/메모장 도구 (예시)
+        'memory': {
+          type: 'stdio',
+          command: 'npx',
+          args: ['-y', '@modelcontextprotocol/server-memory']
+        }
+      }
+    });
+
+    // 사용 가능한 기능 출력
+    const tools = this.client.getAvailableTools();
+    const resources = this.client.getAvailableResources();
+    const prompts = this.client.getAvailablePrompts();
+
+    console.log('✅ 초기화 완료!\n');
+    console.log('📋 사용 가능한 기능:');
+    console.log(`  - 도구: ${tools.length}개`);
+    console.log(`  - 리소스: ${resources.length}개`);
+    console.log(`  - 프롬프트: ${prompts.length}개\n`);
+
+    // 도구 목록 표시
+    if (tools.length > 0) {
+      console.log('🔧 사용 가능한 도구:');
+      const toolsByServer = {};
+      tools.forEach(tool => {
+        if (!toolsByServer[tool.server]) {
+          toolsByServer[tool.server] = [];
+        }
+        toolsByServer[tool.server].push(tool.name);
+      });
+
+      for (const [server, toolNames] of Object.entries(toolsByServer)) {
+        console.log(`  ${server}:`);
+        toolNames.forEach(name => console.log(`    - ${name}`));
+      }
+      console.log();
+    }
+  }
+
+  // 사용자 의도 파싱 (간단한 키워드 기반)
+  parseIntent(message) {
+    const lowerMsg = message.toLowerCase();
+
+    // 파일 관련
+    if (lowerMsg.includes('파일') || lowerMsg.includes('file')) {
+      if (lowerMsg.includes('읽') || lowerMsg.includes('read')) {
+        return { action: 'readFile', query: message };
+      }
+      if (lowerMsg.includes('찾') || lowerMsg.includes('search')) {
+        return { action: 'searchFiles', query: message };
+      }
+      if (lowerMsg.includes('쓰') || lowerMsg.includes('write')) {
+        return { action: 'writeFile', query: message };
+      }
+    }
+
+    // GitHub 관련
+    if (lowerMsg.includes('github') || lowerMsg.includes('깃허브')) {
+      return { action: 'github', query: message };
+    }
+
+    // 메모 관련
+    if (lowerMsg.includes('메모') || lowerMsg.includes('기억') || lowerMsg.includes('저장')) {
+      return { action: 'memory', query: message };
+    }
+
+    // 도구 목록 조회
+    if (lowerMsg.includes('도구') || lowerMsg.includes('기능') || lowerMsg.includes('help')) {
+      return { action: 'listTools', query: message };
+    }
+
+    return { action: 'unknown', query: message };
+  }
+
+  // 메시지 처리
+  async processMessage(message) {
+    this.conversationHistory.push({ role: 'user', content: message });
+
+    const intent = this.parseIntent(message);
+    let response = '';
+
+    try {
+      switch (intent.action) {
+        case 'listTools':
+          response = this.getToolsList();
+          break;
+
+        case 'readFile':
+          response = await this.handleFileRead(message);
+          break;
+
+        case 'searchFiles':
+          response = await this.handleFileSearch(message);
+          break;
+
+        case 'github':
+          response = await this.handleGitHub(message);
+          break;
+
+        case 'memory':
+          response = await this.handleMemory(message);
+          break;
+
+        default:
+          response = await this.handleGeneral(message);
+      }
+
+    } catch (error) {
+      response = `❌ 죄송합니다. 오류가 발생했습니다: ${error.message}`;
+    }
+
+    this.conversationHistory.push({ role: 'assistant', content: response });
+    return response;
+  }
+
+  getToolsList() {
+    const tools = this.client.getAvailableTools();
+    let response = '🔧 사용 가능한 도구:\n\n';
+
+    const byServer = {};
+    tools.forEach(tool => {
+      if (!byServer[tool.server]) byServer[tool.server] = [];
+      byServer[tool.server].push(tool);
+    });
+
+    for (const [server, toolList] of Object.entries(byServer)) {
+      response += `📦 ${server}:\n`;
+      toolList.forEach(tool => {
+        response += `  • ${tool.name}\n`;
+        if (tool.description) {
+          response += `    ${tool.description}\n`;
+        }
+      });
+      response += '\n';
+    }
+
+    return response;
+  }
+
+  async handleFileRead(message) {
+    // 간단한 파일 경로 추출 (실제로는 더 정교한 파싱 필요)
+    const pathMatch = message.match(/["']([^"']+)["']|\/[^\s]+/);
+    if (!pathMatch) {
+      return '파일 경로를 찾을 수 없습니다. 예: "/tmp/test.txt 파일 읽어줘"';
+    }
+
+    const filePath = pathMatch[1] || pathMatch[0];
+
+    try {
+      const result = await this.client.executeTool('read_file', {
+        path: filePath
+      });
+
+      return `📄 파일 내용:\n\n${result.data}`;
+    } catch (error) {
+      return `파일을 읽을 수 없습니다: ${error.message}`;
+    }
+  }
+
+  async handleFileSearch(message) {
+    // 검색어 추출
+    const searchMatch = message.match(/["']([^"']+)["']/);
+    if (!searchMatch) {
+      return '검색어를 찾을 수 없습니다. 예: "test 파일 찾아줘"';
+    }
+
+    try {
+      const result = await this.client.executeTool('search_files', {
+        pattern: searchMatch[1]
+      });
+
+      return `🔍 검색 결과:\n\n${result.data}`;
+    } catch (error) {
+      return `검색 중 오류 발생: ${error.message}`;
+    }
+  }
+
+  async handleGitHub(message) {
+    const tools = this.client.getAvailableTools();
+    const githubTools = tools.filter(t => t.server === 'github');
+
+    if (githubTools.length === 0) {
+      return 'GitHub 도구를 사용할 수 없습니다.';
+    }
+
+    // 첫 번째 GitHub 도구 실행 (예시)
+    try {
+      const result = await this.client.executeTool(githubTools[0].name);
+      return `🐙 GitHub 결과:\n\n${JSON.stringify(result.data, null, 2)}`;
+    } catch (error) {
+      return `GitHub 작업 실패: ${error.message}`;
+    }
+  }
+
+  async handleMemory(message) {
+    // 메모 저장 로직
+    try {
+      const result = await this.client.executeTool('store_memory', {
+        key: 'user_note',
+        value: message
+      });
+
+      return `💾 메모를 저장했습니다.`;
+    } catch (error) {
+      return `메모 저장 실패: ${error.message}`;
+    }
+  }
+
+  async handleGeneral(message) {
+    // 일반 메시지 처리
+    const tools = this.client.getAvailableTools();
+
+    return `저는 다음 기능들을 도울 수 있습니다:\n\n` +
+           `• 파일 읽기/쓰기/검색\n` +
+           `• GitHub 작업\n` +
+           `• 메모 저장\n\n` +
+           `"도구" 또는 "help"를 입력하면 상세한 기능 목록을 볼 수 있습니다.`;
+  }
+
+  async shutdown() {
+    console.log('\n👋 챗봇을 종료합니다...');
+    await this.client.disconnect();
+  }
+}
+
+// ========================================
+// 메인 실행
+// ========================================
+
+async function main() {
+  const chatbot = new MCPChatbot();
+
+  try {
+    await chatbot.initialize();
+
+    // readline 인터페이스 생성
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+
+    console.log('💬 채팅을 시작합니다. (종료: exit, quit, bye)\n');
+
+    // 대화 루프
+    const askQuestion = () => {
+      rl.question('You: ', async (input) => {
+        const message = input.trim();
+
+        // 종료 명령
+        if (['exit', 'quit', 'bye'].includes(message.toLowerCase())) {
+          rl.close();
+          await chatbot.shutdown();
+          return;
+        }
+
+        // 빈 입력 무시
+        if (!message) {
+          askQuestion();
+          return;
+        }
+
+        // 메시지 처리
+        const response = await chatbot.processMessage(message);
+        console.log(`\nBot: ${response}\n`);
+
+        askQuestion();
+      });
+    };
+
+    askQuestion();
+
+  } catch (error) {
+    console.error('❌ 챗봇 초기화 실패:', error.message);
+    process.exit(1);
+  }
+}
+
+main().catch(console.error);