cognitive-framework-mcp-server/examples/usage-example.ts

MCP Server for Advanced Cognitive Framework - Provides sophisticated AI reasoning capabilities through standardized protocol

#!/usr/bin/env node

/**
 * Usage Example for Cognitive Framework MCP Server
 * Demonstrates how to use the MCP server programmatically
 */

import { FrameworkParser } from '../src/parsers/framework-parser.js';
import { CognitiveReasoningEngine } from '../src/engines/cognitive-reasoning-engine.js';
import { CognitiveRequest } from '../src/types/cognitive-framework.js';

async function demonstrateFrameworkUsage() {
  console.log('🧠 Advanced Cognitive Framework MCP Server - Usage Example\n');

  try {
    // Initialize the framework parser
    console.log('📖 Parsing cognitive framework...');
    const frameworkPath = process.env.FRAMEWORK_PATH || '/home/zrald/test/improve context';
    const parser = new FrameworkParser(frameworkPath);
    
    // Parse the framework
    const framework = await parser.parseFramework();
    console.log('✅ Framework parsed successfully');
    
    // Validate the framework
    const isValid = parser.validateFramework();
    console.log(`🔍 Framework validation: ${isValid ? 'PASSED' : 'FAILED'}`);
    
    // Get framework statistics
    const stats = parser.getFrameworkStats();
    console.log('\n📊 Framework Statistics:');
    console.log(`   • Cognitive Traits: ${stats.cognitiveTraits}`);
    console.log(`   • Meta-Cognitive Capabilities: ${stats.metaCognitiveCapabilities}`);
    console.log(`   • Principles: ${stats.principles}`);
    console.log(`   • Heuristics: ${stats.heuristics}`);
    console.log(`   • Protocols: ${stats.protocols}`);
    console.log(`   • Workflows: ${stats.workflows}`);
    console.log(`   • Operational Steps: ${stats.operationalSteps}`);

    // Initialize the reasoning engine
    console.log('\n🚀 Initializing cognitive reasoning engine...');
    const reasoningEngine = new CognitiveReasoningEngine(framework);
    console.log('✅ Reasoning engine initialized');

    // Example 1: Basic reasoning request
    console.log('\n🧪 Example 1: Basic Cognitive Reasoning');
    const basicRequest: CognitiveRequest = {
      type: 'reasoning',
      input: 'How can we improve team collaboration in remote work environments?',
      context: {
        domain: 'organizational-psychology',
        urgency: 'medium'
      },
      options: {
        workflow: 'holistic',
        biasChecking: true,
        creativityLevel: 'medium'
      }
    };

    const basicResponse = await reasoningEngine.processRequest(basicRequest);
    console.log('📝 Result:', basicResponse.result);
    console.log('🎯 Confidence:', `${(basicResponse.confidence * 100).toFixed(1)}%`);
    console.log('🔍 Reasoning Steps:', basicResponse.reasoning.length);
    console.log('⚖️ Bias Checks:', basicResponse.biasChecks?.length || 0);

    // Example 2: Creative problem solving
    console.log('\n🎨 Example 2: Creative Problem Solving');
    const creativeRequest: CognitiveRequest = {
      type: 'analysis',
      input: 'Design an innovative solution for reducing urban traffic congestion',
      context: {
        domain: 'urban-planning',
        constraints: ['budget-limited', 'environmentally-friendly']
      },
      options: {
        workflow: 'adaptive',
        creativityLevel: 'high',
        biasChecking: true
      }
    };

    const creativeResponse = await reasoningEngine.processRequest(creativeRequest);
    console.log('📝 Result:', creativeResponse.result);
    console.log('🎯 Confidence:', `${(creativeResponse.confidence * 100).toFixed(1)}%`);
    console.log('💡 Alternatives:', creativeResponse.alternatives?.length || 0);

    // Example 3: Technical analysis
    console.log('\n⚙️ Example 3: Technical Analysis');
    const technicalRequest: CognitiveRequest = {
      type: 'analysis',
      input: 'Evaluate the trade-offs between microservices and monolithic architecture for a growing startup',
      context: {
        domain: 'software-architecture',
        teamSize: 'small',
        growthStage: 'early'
      },
      options: {
        workflow: 'holistic',
        confidenceThreshold: 0.8,
        biasChecking: true
      }
    };

    const technicalResponse = await reasoningEngine.processRequest(technicalRequest);
    console.log('📝 Result:', technicalResponse.result);
    console.log('🎯 Confidence:', `${(technicalResponse.confidence * 100).toFixed(1)}%`);
    console.log('⏱️ Processing Time:', `${technicalResponse.metadata.processingTime}ms`);
    console.log('🧠 Cognitive Load:', technicalResponse.metadata.cognitiveLoad);

    // Display framework information
    console.log('\n📋 Framework Information:');
    const frameworkInfo = reasoningEngine.getFrameworkInfo();
    console.log('   • Active Sessions:', frameworkInfo.activeSessions);
    console.log('   • Available Principles:', frameworkInfo.principles);
    console.log('   • Available Heuristics:', frameworkInfo.heuristics);
    console.log('   • Available Workflows:', frameworkInfo.workflows);

    // Display cache statistics
    console.log('\n💾 Cache Statistics:');
    const cacheStats = reasoningEngine.getCacheStats();
    console.log('   • Keys:', cacheStats.keys);
    console.log('   • Hits:', cacheStats.hits);
    console.log('   • Misses:', cacheStats.misses);
    console.log('   • Hit Rate:', `${((cacheStats.hits / (cacheStats.hits + cacheStats.misses)) * 100 || 0).toFixed(1)}%`);

    console.log('\n🎉 Demonstration completed successfully!');
    console.log('\n📚 The Advanced Cognitive Framework provides:');
    console.log('   • Meta-cognitive reasoning with self-awareness');
    console.log('   • Systematic bias detection and mitigation');
    console.log('   • Uncertainty quantification and confidence modeling');
    console.log('   • Multi-perspective analysis and creative problem-solving');
    console.log('   • Adaptive workflows that scale with complexity');
    console.log('   • Continuous learning and performance optimization');

  } catch (error) {
    console.error('❌ Error during demonstration:', error);
    process.exit(1);
  }
}

// Run the demonstration
if (import.meta.url === `file://${process.argv[1]}`) {
  demonstrateFrameworkUsage().catch(console.error);
}

export { demonstrateFrameworkUsage };