mlgym-deploy 3.3.41 → 3.3.43

package/README.md

@@ -32,12 +32,47 @@ Configure in your MCP client settings:
 
 ## Configuration
 
+### For Published Package (Production)
+
 Set the backend URL via environment variable:
 
 ```bash
 export MLGYM_BACKEND_URL=https://backend.eu.ezb.net
 ```
 
+### For Local Development
+
+When developing locally, you'll need to configure the MCP server with absolute paths. Configuration files are user-specific and not tracked in git.
+
+1. **Copy example files** to create your local config:
+
+```bash
+cp cursor-config.json.example cursor-config.json
+cp mcp.json.example mcp.json
+cp claude-desktop-config.json.example claude-desktop-config.json
+cp ADD_TO_CURSOR_SETTINGS.json.example ADD_TO_CURSOR_SETTINGS.json
+```
+
+2. **Update the path** in your config file with your absolute path:
+
+```json
+{
+  "mcpServers": {
+    "gitlab-backend": {
+      "command": "node",
+      "args": ["/your/absolute/path/to/gitlab_backend/mcp-server/index.js"],
+      "env": {
+        "GITLAB_BACKEND_URL": "https://backend.eu.ezb.net",
+        "GITLAB_URL": "https://git.mlgym.io",
+        "COOLIFY_URL": "https://coolify.eu.ezb.net"
+      }
+    }
+  }
+}
+```
+
+**Note:** Absolute paths are required because the IDE launches the MCP server from its own working directory, not the project directory. Relative paths won't work.
+
 ## License
 
 MIT

package/claude-desktop-config.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "gitlab-backend": {
       "command": "node",
-      "args": ["/home/chka/NetBeansProjects/gitlab_backend/mcp-server/index.js"]
+      "args": ["/home/sreedhar/Work/Projects/mlgym/gitlab_backend/mcp-server/index.js"]
     }
   }
 }

package/claude-desktop-config.json.example

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "gitlab-backend": {
+      "command": "node",
+      "args": ["/path/to/your/gitlab_backend/mcp-server/index.js"]
+    }
+  }
+}

package/cursor-config.json

@@ -2,7 +2,7 @@
   "mcp.servers": {
     "gitlab-backend": {
       "command": "node",
-      "args": ["/home/chka/NetBeansProjects/gitlab_backend/mcp-server/index.js"],
+      "args": ["/home/sreedhar/Work/Projects/mlgym/gitlab_backend/mcp-server/index.js"],
       "env": {
         "GITLAB_BACKEND_URL": "https://backend.eu.ezb.net",
         "GITLAB_URL": "https://git.mlgym.io",

package/cursor-config.json.example

@@ -0,0 +1,13 @@
+{
+  "mcp.servers": {
+    "gitlab-backend": {
+      "command": "node",
+      "args": ["/path/to/your/gitlab_backend/mcp-server/index.js"],
+      "env": {
+        "GITLAB_BACKEND_URL": "https://backend.eu.ezb.net",
+        "GITLAB_URL": "https://git.mlgym.io",
+        "COOLIFY_URL": "https://coolify.eu.ezb.net"
+      }
+    }
+  }
+}

package/docs/CURSOR_SETUP.md

@@ -0,0 +1,204 @@
+# MCP Setup Guide for Cursor IDE
+
+## Prerequisites
+✅ Node.js installed
+✅ MCP dependencies installed (already done)
+✅ Cursor IDE with MCP support
+
+## Setup Instructions
+
+### 1. Configure MCP in Cursor
+
+Open Cursor Settings (Cmd/Ctrl+,) and add the MCP server configuration:
+
+```json
+{
+  "mcp.servers": {
+    "mlgym-deploy": {
+      "command": "node",
+      "args": ["${workspaceFolder}/mcp-server/index.js"],
+      "env": {
+        "GITLAB_BACKEND_URL": "https://backend.eu.ezb.net",
+        "GITLAB_URL": "https://git.mlgym.io",
+        "COOLIFY_URL": "https://coolify.eu.ezb.net"
+      }
+    }
+  }
+}
+```
+
+### 2. Using MCP Tools in Cursor
+
+Once MCP is configured, you can use these commands directly in Cursor chat:
+
+```
+@mcp mlgym_user_create    - Create a new user account
+@mcp mlgym_auth_login     - Login with existing credentials
+@mcp mlgym_deploy         - Deploy a project (recommended)
+@mcp mlgym_status         - Check deployment status
+@mcp mlgym_deploy_logs    - View deployment logs
+```
+
+### 3. MCP Tool Details
+
+#### mlgym_user_create
+Creates a complete user account with:
+- GitLab account
+- Coolify account
+- SSH key generation and registration
+- Authentication token storage
+
+**Parameters:**
+- `email` (required): User email address
+- `name` (required): User full name
+- `password` (required): User password (min 8 characters)
+- `accept_terms` (required): Must be `true`
+
+**Example:**
+```json
+{
+  "email": "user@example.com",
+  "name": "John Doe",
+  "password": "SecurePass123!",
+  "accept_terms": true
+}
+```
+
+#### mlgym_auth_login
+Login with existing user credentials to get authentication token.
+
+**Parameters:**
+- `email` (required): Email address
+- `password` (required): Password
+
+**Example:**
+```json
+{
+  "email": "user@example.com",
+  "password": "SecurePass123!"
+}
+```
+
+#### mlgym_deploy (RECOMMENDED)
+Complete deployment workflow in one call. Automatically authenticates (uses cached token if available), analyzes project, creates GitLab repo, and deploys to Coolify.
+
+**Parameters:**
+- `project_name` (required): Project name (lowercase alphanumeric with hyphens, e.g., "my-app")
+- `project_description` (required): Brief project description (min 10 characters)
+- `email` (optional): Email for authentication (if not already authenticated)
+- `password` (optional): Password (if not already authenticated)
+- `hostname` (optional): Custom hostname
+- `local_path` (optional): Local project directory path (defaults to current directory)
+- `project_type` (optional): Override auto-detected type (nodejs, python, static, go)
+- `framework` (optional): Override auto-detected framework (nextjs, express, react, vue, flask, fastapi, html)
+
+**Example:**
+```json
+{
+  "project_name": "my-awesome-app",
+  "project_description": "A simple Node.js application",
+  "email": "user@example.com",
+  "password": "SecurePass123!",
+  "local_path": "."
+}
+```
+
+#### Other Available Tools
+
+- **mlgym_status**: Check deployment status and project configuration
+- **mlgym_deploy_logs**: View deployment logs (requires project_name)
+- **mlgym_set_env_vars**: Set environment variables for deployment
+- **mlgym_set_health_check**: Configure health check endpoints
+- **mlgym_set_domain**: Set custom domain for deployment
+- **mlgym_set_deployment_commands**: Configure build/start commands
+- **mlgym_deploy_manual**: Manual deployment trigger
+- **mlgym_set_options**: Configure deployment options
+- **mlgym_rollback**: Rollback to previous deployment
+- **mlgym_help**: Get help on available tools
+
+### 4. Typical Workflow
+
+#### First-time User
+1. Create account: `@mcp mlgym_user_create`
+2. Deploy project: `@mcp mlgym_deploy` (includes authentication)
+
+#### Existing User
+1. Login: `@mcp mlgym_auth_login` (or use credentials in mlgym_deploy)
+2. Deploy project: `@mcp mlgym_deploy`
+3. Check status: `@mcp mlgym_status`
+4. View logs: `@mcp mlgym_deploy_logs`
+
+### 5. Testing MCP Connection
+
+Test that MCP is working:
+```bash
+# Test the MCP server directly
+node mcp-server/index.js
+
+# Should output the MCP protocol initialization message
+```
+
+### 6. Authentication
+
+MCP stores authentication tokens in `~/.mlgym/mcp_config.json` automatically after:
+- First user creation (`mlgym_user_create`)
+- Successful login (`mlgym_auth_login`)
+- Successful deployment with credentials (`mlgym_deploy`)
+
+### 7. Troubleshooting
+
+If MCP tools don't appear in Cursor:
+1. Restart Cursor after configuration
+2. Check the MCP server is accessible:
+   ```bash
+   node mcp-server/index.js
+   ```
+3. Verify settings in Cursor preferences (look for "mcp.servers")
+4. Check Cursor logs for MCP errors (View → Output → MCP)
+5. Ensure you're using Cursor with MCP support (latest version)
+
+### 8. Debug Mode
+
+Debug logging is enabled by default. To see detailed output:
+```bash
+# Start Cursor from terminal to see MCP logs
+cd ~/your-project
+cursor .
+```
+
+See [DEBUG.md](./DEBUG.md) for more details on debug logging.
+
+## Environment Variables
+
+The MCP server uses these production endpoints:
+- **Backend**: https://backend.eu.ezb.net
+- **GitLab**: https://git.mlgym.io
+- **Coolify**: https://coolify.eu.ezb.net
+
+These are pre-configured in the MCP server configuration.
+
+## Quick Test
+
+```bash
+# In Cursor terminal, test user creation
+echo '{
+  "jsonrpc": "2.0",
+  "method": "tools/call",
+  "params": {
+    "name": "mlgym_user_create",
+    "arguments": {
+      "email": "test@example.com",
+      "name": "Test User",
+      "password": "TestPass123!",
+      "accept_terms": true
+    }
+  },
+  "id": 1
+}' | node mcp-server/index.js
+```
+
+## Additional Resources
+
+- [Debug Guide](./DEBUG.md) - Enable and configure debug logging
+- [Test Results](../tests/TEST_RESULTS.md) - Current test coverage and results
+- Production Backend: https://backend.eu.ezb.net

package/index.js

@@ -18,7 +18,7 @@ import crypto from 'crypto';
 const execAsync = promisify(exec);
 
 // Current version of this MCP server - INCREMENT FOR WORKFLOW FIXES
-const CURRENT_VERSION = '3.3.40';  // Fix auth.jwt_token -> auth.token consistency bug
+const CURRENT_VERSION = '3.3.43';  // Add embedded contact info (operations@stratus5.com) and hide infrastructure URLs from help
 const PACKAGE_NAME = 'mlgym-deploy';
 
 // Debug logging configuration - ENABLED BY DEFAULT
@@ -90,7 +90,13 @@ const CONFIG = {
   backend_url: process.env.MLGYM_API_ENDPOINT || 'https://backend.eu.ezb.net',
   gitlab_url: 'https://git.mlgym.io',
   coolify_url: 'https://coolify.eu.ezb.net',
-  config_file: path.join(os.homedir(), '.mlgym', 'mcp_config.json')
+  config_file: path.join(os.homedir(), '.mlgym', 'mcp_config.json'),
+
+  // Contact information (user-facing)
+  contact: {
+    support_email: 'operations@stratus5.com',
+    docs_url: 'https://mlgym.info'
+  }
 };
 
 // Helper to load/save authentication
@@ -3434,6 +3440,205 @@ async function deployProject(args) {
   }
 }
 
+// ============================================================================
+// DOLLIE DEPLOYMENT - Next.js Dev Containers with SSH
+// ============================================================================
+async function deployDollie(args) {
+  const {
+    project_name,
+    project_description,
+    git_repo_url,
+    git_branch = '',
+    git_token = '',
+    app_port = 3000,
+    email,
+    password
+  } = args;
+
+  log.info('MCP >>> Starting Dollie deployment workflow');
+  log.debug('MCP >>> Arguments:', { project_name, git_repo_url, git_branch, app_port });
+
+  try {
+    // Step 1: Authenticate
+    log.info('MCP >>> STEP 1: Authenticating...');
+    const auth = await loadAuth();
+
+    // If not authenticated and credentials provided, authenticate
+    if (!auth.token && email && password) {
+      const loginResult = await apiRequest('POST', '/api/v1/auth/login', {
+        email,
+        password
+      }, false);
+
+      if (!loginResult.success || !loginResult.data.token) {
+        return {
+          content: [{
+            type: 'text',
+            text: JSON.stringify({
+              status: 'error',
+              message: 'Authentication failed',
+              error: loginResult.error || 'Invalid credentials',
+              next_steps: [
+                'Provide valid email and password',
+                'Or ensure you are already logged in'
+              ]
+            }, null, 2)
+          }]
+        };
+      }
+
+      await saveAuth(email, loginResult.data.token);
+      log.success('MCP >>> STEP 1: Authentication successful');
+    } else if (!auth.token) {
+      return {
+        content: [{
+          type: 'text',
+          text: JSON.stringify({
+            status: 'error',
+            message: 'Authentication required',
+            error: 'No authentication token found and no credentials provided',
+            next_steps: [
+              'Provide email and password in the request',
+              'Or use mlgym_auth_login first'
+            ]
+          }, null, 2)
+        }]
+      };
+    } else {
+      log.success('MCP >>> STEP 1: Using existing authentication');
+    }
+
+    // Step 2: Get current user info
+    log.info('MCP >>> STEP 2: Getting user information...');
+    const userResult = await apiRequest('GET', '/api/v1/user', null, true);
+
+    if (!userResult.success) {
+      return {
+        content: [{
+          type: 'text',
+          text: JSON.stringify({
+            status: 'error',
+            message: 'Failed to get user information',
+            error: userResult.error
+          }, null, 2)
+        }]
+      };
+    }
+
+    log.success('MCP >>> STEP 2: User information retrieved');
+
+    // Step 3: Generate SSH password
+    log.info('MCP >>> STEP 3: Generating SSH password...');
+    const sshPassword = generateRandomPassword();
+    log.success('MCP >>> STEP 3: SSH password generated');
+
+    // Step 4: Prepare environment variables
+    log.info('MCP >>> STEP 4: Preparing environment variables...');
+    const environmentVariables = {
+      GIT_REPO_URL: git_repo_url,
+      GIT_BRANCH: git_branch,
+      GIT_TOKEN: git_token,
+      SSH_PASSWORD: sshPassword,
+      S5_USERNAME: 'developer',
+      APP_PORT: app_port.toString(),
+      SSH_PORT: '22'
+    };
+    log.success('MCP >>> STEP 4: Environment variables prepared');
+    log.debug('MCP >>> Environment variables:', Object.keys(environmentVariables));
+
+    // Step 5: Create Coolify resource with docker-image
+    log.info('MCP >>> STEP 5: Creating Coolify deployment...');
+    const createResult = await apiRequest('POST', '/api/v1/projects', {
+      name: project_name,
+      description: project_description,
+      repository: '', // Not needed for docker-image deployments
+      branch: '',
+      build_pack: 'docker-image',
+      docker_image: 'code.stratus5.com:5050/dollie/dollie/nextjs-dev:latest',
+      environment_variables: environmentVariables,
+      ports_exposes: app_port.toString()
+    }, true);
+
+    if (!createResult.success) {
+      return {
+        content: [{
+          type: 'text',
+          text: JSON.stringify({
+            status: 'error',
+            message: 'Failed to create Dollie deployment',
+            error: createResult.error,
+            step: 'create_coolify_resource'
+          }, null, 2)
+        }]
+      };
+    }
+
+    log.success('MCP >>> STEP 5: Coolify deployment created');
+
+    // Step 6: Extract deployment details
+    const deployment = createResult.data;
+    const appUuid = deployment.coolify_uuid;
+    const appUrl = deployment.url;
+
+    // Parse URL to extract hostname
+    const urlObj = new URL(appUrl);
+    const hostname = urlObj.hostname;
+
+    // Determine SSH port based on node (typically 2201 for all nodes)
+    const sshPort = 2201;
+
+    log.success('MCP >>> Dollie deployment completed successfully');
+
+    return {
+      content: [{
+        type: 'text',
+        text: JSON.stringify({
+          success: true,
+          deployment: {
+            url: appUrl,
+            ssh: {
+              host: hostname,
+              port: sshPort,
+              username: 'developer',
+              password: sshPassword
+            },
+            status: 'deploying',
+            coolify_uuid: appUuid,
+            project_name: project_name,
+            git_repo: git_repo_url,
+            git_branch: git_branch || 'default',
+            app_port: app_port
+          },
+          next_steps: [
+            `Container is deploying at ${appUrl}`,
+            `SSH access: ssh developer@${hostname} -p ${sshPort}`,
+            `Password: ${sshPassword}`,
+            'The container will:',
+            '  1. Clone your git repository',
+            '  2. Install dependencies (npm/yarn/pnpm)',
+            '  3. Start Next.js dev server',
+            '  4. Enable SSH access',
+            'Wait 2-3 minutes for deployment to complete'
+          ]
+        }, null, 2)
+      }]
+    };
+
+  } catch (error) {
+    log.error('MCP >>> Dollie deployment failed:', error.message);
+    return {
+      content: [{
+        type: 'text',
+        text: JSON.stringify({
+          status: 'error',
+          message: 'Dollie deployment failed',
+          error: error.message
+        }, null, 2)
+      }]
+    };
+  }
+}
+
 // ============================================================================
 // SIMPLIFIED STATUS CHECK
 // ============================================================================
@@ -4420,8 +4625,7 @@ Examples show both what users say AND the tool call that gets executed.
 💡 Most parameters are optional with sensible defaults
 
 📚 Documentation: https://mlgym.info
-🌐 Backend: https://backend.eu.ezb.net
-📊 Dashboard: https://platform.mlgym.info
+📧 Support: operations@stratus5.com
 `;
 
   return {
@@ -4767,6 +4971,55 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           }
         }
       },
+      {
+        name: 'deploy_dollie',
+        description: 'Deploy a Next.js development container with SSH access for AI-assisted development. Uses the Dollie base image which clones your git repository and runs the dev server. Supports any public git repo or private repos with token authentication.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            project_name: {
+              type: 'string',
+              description: 'Project name (lowercase alphanumeric with hyphens, e.g., "my-nextjs-app")',
+              pattern: '^[a-z0-9][a-z0-9-]*[a-z0-9]$',
+              minLength: 3
+            },
+            project_description: {
+              type: 'string',
+              description: 'Brief project description (min 10 characters)',
+              minLength: 10
+            },
+            git_repo_url: {
+              type: 'string',
+              description: 'Git repository URL (https://github.com/user/repo.git)',
+              pattern: '^https://.*\\.git$'
+            },
+            git_branch: {
+              type: 'string',
+              description: 'Branch to clone (optional, defaults to repo\'s default branch)'
+            },
+            git_token: {
+              type: 'string',
+              description: 'OAuth token for private repos (optional)'
+            },
+            app_port: {
+              type: 'number',
+              description: 'Next.js port inside container (optional, default: 3000)',
+              default: 3000
+            },
+            email: {
+              type: 'string',
+              description: 'Email for authentication (optional if already authenticated)',
+              pattern: '^[^@]+@[^@]+\\.[^@]+$'
+            },
+            password: {
+              type: 'string',
+              description: 'Password (optional if already authenticated, min 8 characters)',
+              minLength: 8
+            }
+          },
+          required: ['project_name', 'project_description', 'git_repo_url']
+        }
+      },
       {
         name: 'mlgym_help',
         description: 'Display all available MLGym tools with descriptions and usage examples. Use this to discover what operations you can perform.',
@@ -4902,13 +5155,18 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         result = await rollback(args);
         break;
 
+      case 'deploy_dollie':
+        log.info(`Deploying Dollie development container...`);
+        result = await deployDollie(args);
+        break;
+
       case 'mlgym_help':
         log.info(`Showing help...`);
         result = await showHelp(args);
         break;
 
       default:
-        throw new Error(`Unknown tool: ${name}. Available tools: mlgym_deploy, mlgym_status, mlgym_deploy_logs, mlgym_user_create, mlgym_auth_login, mlgym_set_env_vars, mlgym_set_health_check, mlgym_set_domain, mlgym_set_deployment_commands, mlgym_deploy_manual, mlgym_set_options, mlgym_rollback`);
+        throw new Error(`Unknown tool: ${name}. Available tools: mlgym_deploy, mlgym_status, mlgym_deploy_logs, deploy_dollie, mlgym_user_create, mlgym_auth_login, mlgym_set_env_vars, mlgym_set_health_check, mlgym_set_domain, mlgym_set_deployment_commands, mlgym_deploy_manual, mlgym_set_options, mlgym_rollback`);
     }
 
     const duration = Date.now() - startTime;

package/mcp.json.example

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "gitlab-backend": {
+      "command": "node",
+      "args": ["/path/to/your/gitlab_backend/mcp-server/index.js"],
+      "env": {
+        "GITLAB_BACKEND_URL": "https://backend.eu.ezb.net",
+        "GITLAB_URL": "https://git.mlgym.io",
+        "COOLIFY_URL": "https://coolify.eu.ezb.net"
+      }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mlgym-deploy",
-  "version": "3.3.41",
+  "version": "3.3.43",
   "description": "MCP server for MLGym - Complete deployment management: deploy, configure, monitor, and rollback applications",
   "main": "index.js",
   "type": "module",
@@ -20,13 +20,17 @@
   ],
   "author": "MLGym Team",
   "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "repository": {
     "type": "git",
     "url": "git@code.stratus5.com:chka/gitlab_backend.git"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^0.6.0",
-    "axios": "^1.6.0"
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "axios": "^1.6.0",
+    "package": "*"
   },
   "mcp": {
     "name": "MLGym Deploy",
@@ -80,6 +84,10 @@
         "name": "mlgym_rollback",
         "description": "Rollback to previous deployment"
       },
+      {
+        "name": "deploy_dollie",
+        "description": "Deploy Next.js development container with SSH access using pre-built Dollie image"
+      },
       {
         "name": "mlgym_help",
         "description": "Display all available tools with descriptions and usage examples"

package/tests/README.md

@@ -13,7 +13,8 @@ tests/
 ├── mlgym_auth_logout_test.sh         # ✅ 8 tests (auth_logout)
 ├── mlgym_project_init_test.sh        # ✅ 6 tests (project_init)
 ├── mlgym_projects_list_test.sh       # ✅ 6 tests (projects_list)
-└── mlgym_projects_get_test.sh        # ✅ 7 tests (projects_get)
+├── mlgym_projects_get_test.sh        # ✅ 7 tests (projects_get)
+└── deploy_dollie_test.sh             # ✅ 20 tests (deploy_dollie)
 ```
 
 ## Running Tests
@@ -32,7 +33,7 @@ cd mcp-server
 
 ## Test Coverage
 
-### Completed (6 functions, 62 total tests)
+### Completed (7 functions, 82 total tests)
 - ✅ **mlgym_auth_login** (15 tests)
   - Valid/invalid credentials, SQL injection, XSS, buffer overflow, token storage
 - ✅ **mlgym_user_create** (20 tests)
@@ -45,6 +46,10 @@ cd mcp-server
   - List projects, user isolation, response format
 - ✅ **mlgym_projects_get** (7 tests)
   - Get project details, validation, non-existent projects
+- ✅ **deploy_dollie** (20 tests)
+  - Authentication, deployment workflow, public repos, custom ports/branches
+  - Required fields, validation, security (SQL injection, XSS, buffer overflow)
+  - Response format, SSH password strength
 
 ### Remaining (37 functions)
 See TODO.md for priority order and testing plan.