mlgym-deploy 3.0.5 → 3.0.6

package/DEBUG.md

@@ -0,0 +1,78 @@
+# MCP Debug Mode
+
+## Debug Logging (Enabled by Default)
+
+**✨ Debug mode is ON by default!** You'll automatically see detailed messages when you start Cursor from a terminal.
+
+### To see debug output:
+```bash
+# Just start Cursor from terminal
+cd ~/your-project
+cursor .
+```
+
+### To DISABLE debug logging (if too verbose):
+```bash
+export MLGYM_DEBUG=false
+cursor .
+```
+
+Or:
+```bash
+export DEBUG=off
+cursor .
+```
+
+## What You'll See
+
+When debug mode is enabled, you'll see colored output in the terminal:
+
+```
+╔═══════════════════════════════════════════════════════╗
+║  MLGym MCP Server v3.0.6                              ║
+╚═══════════════════════════════════════════════════════╝
+Backend: https://backend.eu.ezb.net
+Debug mode: ENABLED
+✓ Server ready and waiting for requests...
+
+[12:34:56.789] ℹ INFO ═══════════════════════════════════════════════════
+[12:34:56.790] ℹ INFO Tool called: mlgym_deploy (MCP v3.0.6)
+[12:34:56.791] ⋯ DEBUG Arguments: {...}
+[12:34:56.792] ℹ INFO Starting deployment workflow...
+[12:34:58.123] ✓ SUCCESS Tool mlgym_deploy completed in 1331ms
+[12:34:58.124] ℹ INFO ═══════════════════════════════════════════════════
+```
+
+## Log Levels
+
+- **ℹ INFO** (cyan) - General information about operations
+- **✓ SUCCESS** (green) - Successful completions
+- **⚠ WARNING** (yellow) - Non-fatal issues (always shown)
+- **✗ ERROR** (red) - Errors and failures (always shown)
+- **⋯ DEBUG** (dim) - Detailed debugging info (only in debug mode)
+
+## Debugging Tips
+
+1. **Start Cursor from terminal** to see the output:
+   ```bash
+   cd ~/your-project
+   cursor .
+   ```
+
+2. **Check the terminal** where you launched Cursor - all MCP logs appear there
+
+3. **Errors and warnings** are always shown
+
+4. **Disable debug mode** if output is too verbose:
+   ```bash
+   export MLGYM_DEBUG=false
+   cursor .
+   ```
+
+## Troubleshooting
+
+If you don't see debug messages:
+1. Make sure you started Cursor from a terminal (not from GUI/Dock)
+2. Check that you're using MCP v3.0.6 or later
+3. Verify debug isn't explicitly disabled: `echo $MLGYM_DEBUG`
+4. Look at the terminal where you launched Cursor, not inside Cursor itself

package/index.js

@@ -17,9 +17,68 @@ import crypto from 'crypto';
 const execAsync = promisify(exec);
 
 // Current version of this MCP server - INCREMENT FOR WORKFLOW FIXES
-const CURRENT_VERSION = '3.0.5';  // Better git push error visibility and status reporting
+const CURRENT_VERSION = '3.0.6';  // Added debug logging with colored terminal output
 const PACKAGE_NAME = 'mlgym-deploy';
 
+// Debug logging configuration - ENABLED BY DEFAULT
+const DEBUG_ENABLED = process.env.MLGYM_DEBUG !== 'false' && process.env.DEBUG !== 'off';
+const DEBUG_COLORS = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  dim: '\x1b[2m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  magenta: '\x1b[35m',
+  blue: '\x1b[34m'
+};
+
+// Enhanced debug logging functions
+function debugLog(level, message, ...args) {
+  const timestamp = new Date().toISOString().split('T')[1].replace('Z', '');
+  let color = DEBUG_COLORS.reset;
+  let prefix = '';
+
+  switch(level) {
+    case 'info':
+      color = DEBUG_COLORS.cyan;
+      prefix = 'ℹ INFO';
+      break;
+    case 'success':
+      color = DEBUG_COLORS.green;
+      prefix = '✓ SUCCESS';
+      break;
+    case 'warning':
+      color = DEBUG_COLORS.yellow;
+      prefix = '⚠ WARNING';
+      break;
+    case 'error':
+      color = DEBUG_COLORS.red;
+      prefix = '✗ ERROR';
+      break;
+    case 'debug':
+      color = DEBUG_COLORS.dim;
+      prefix = '⋯ DEBUG';
+      break;
+    default:
+      prefix = '• LOG';
+  }
+
+  if (DEBUG_ENABLED || level === 'error' || level === 'warning') {
+    console.error(`${DEBUG_COLORS.dim}[${timestamp}]${DEBUG_COLORS.reset} ${color}${prefix}${DEBUG_COLORS.reset} ${message}`, ...args);
+  }
+}
+
+// Convenience logging functions
+const log = {
+  info: (msg, ...args) => debugLog('info', msg, ...args),
+  success: (msg, ...args) => debugLog('success', msg, ...args),
+  warning: (msg, ...args) => debugLog('warning', msg, ...args),
+  error: (msg, ...args) => debugLog('error', msg, ...args),
+  debug: (msg, ...args) => debugLog('debug', msg, ...args)
+};
+
 // Version check state
 let versionCheckResult = null;
 let lastVersionCheck = 0;
@@ -1863,27 +1922,47 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
   const { name, arguments: args } = request.params;
 
-  console.error(`Tool called: ${name} (MCP v${CURRENT_VERSION})`);
+  log.info(`═══════════════════════════════════════════════════`);
+  log.info(`Tool called: ${DEBUG_COLORS.bright}${name}${DEBUG_COLORS.reset} (MCP v${CURRENT_VERSION})`);
+  log.debug(`Arguments:`, JSON.stringify(args, null, 2));
 
   try {
+    let result;
+    const startTime = Date.now();
+
     switch (name) {
       case 'mlgym_deploy':
-        return await deployProject(args);
+        log.info(`Starting deployment workflow...`);
+        result = await deployProject(args);
+        break;
 
       case 'mlgym_status':
-        return await getStatus(args);
+        log.info(`Checking status...`);
+        result = await getStatus(args);
+        break;
 
       case 'mlgym_user_create':
-        return await createUser(args);
+        log.info(`Creating user account...`);
+        result = await createUser(args);
+        break;
 
       case 'mlgym_auth_login':
-        return await loginUser(args);
+        log.info(`Authenticating user...`);
+        result = await loginUser(args);
+        break;
 
       default:
         throw new Error(`Unknown tool: ${name}. Available tools: mlgym_deploy, mlgym_status, mlgym_user_create, mlgym_auth_login`);
     }
+
+    const duration = Date.now() - startTime;
+    log.success(`Tool ${name} completed in ${duration}ms`);
+    log.info(`═══════════════════════════════════════════════════`);
+
+    return result;
   } catch (error) {
-    console.error(`Tool execution failed:`, error);
+    log.error(`Tool execution failed:`, error.message);
+    log.error(`Stack trace:`, error.stack);
     return {
       content: [{
         type: 'text',
@@ -1900,10 +1979,23 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error(`MLGym MCP Server v${CURRENT_VERSION} started`);
+
+  console.error(`\n${DEBUG_COLORS.bright}${DEBUG_COLORS.cyan}╔═══════════════════════════════════════════════════════╗${DEBUG_COLORS.reset}`);
+  console.error(`${DEBUG_COLORS.bright}${DEBUG_COLORS.cyan}║${DEBUG_COLORS.reset}  ${DEBUG_COLORS.bright}MLGym MCP Server v${CURRENT_VERSION}${DEBUG_COLORS.reset}                        ${DEBUG_COLORS.bright}${DEBUG_COLORS.cyan}║${DEBUG_COLORS.reset}`);
+  console.error(`${DEBUG_COLORS.bright}${DEBUG_COLORS.cyan}╚═══════════════════════════════════════════════════════╝${DEBUG_COLORS.reset}`);
+  console.error(`${DEBUG_COLORS.dim}Backend: ${CONFIG.backend_url}${DEBUG_COLORS.reset}`);
+  console.error(`${DEBUG_COLORS.dim}Debug mode: ${DEBUG_ENABLED ? DEBUG_COLORS.green + 'ENABLED (default)' : DEBUG_COLORS.yellow + 'DISABLED'}${DEBUG_COLORS.reset}`);
+
+  if (!DEBUG_ENABLED) {
+    console.error(`${DEBUG_COLORS.yellow}💡 Debug disabled. To re-enable: unset MLGYM_DEBUG${DEBUG_COLORS.reset}`);
+  } else {
+    console.error(`${DEBUG_COLORS.dim}💡 To disable debug: export MLGYM_DEBUG=false${DEBUG_COLORS.reset}`);
+  }
+
+  console.error(`${DEBUG_COLORS.green}✓ Server ready and waiting for requests...${DEBUG_COLORS.reset}\n`);
 }
 
 main().catch((error) => {
-  console.error('Server error:', error);
+  log.error('Server startup failed:', error);
   process.exit(1);
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mlgym-deploy",
-  "version": "3.0.5",
-  "description": "MCP server for MLGym - Improved git push error visibility and status reporting",
+  "version": "3.0.6",
+  "description": "MCP server for MLGym - Added debug logging with colored terminal output",
   "main": "index.js",
   "type": "module",
   "bin": {