mlgym-deploy 2.0.0

package/ADD_TO_CURSOR_SETTINGS.json

@@ -0,0 +1,28 @@
+{
+    "workbench.colorTheme": "Atom One Dark",
+    "workbench.startupEditor": "none",
+    "cmake.configureOnOpen": true,
+    "cmake.options.statusBarVisibility": "visible",
+    "cmake.showOptionsMovedNotification": false,
+    "redhat.telemetry.enabled": true,
+    "makefile.configureOnOpen": true,
+    "explorer.confirmDelete": false,
+    "git.openRepositoryInParentFolders": "never",
+    "workbench.iconTheme": "material-icon-theme",
+    "editor.formatOnSave": true,
+    "editor.defaultFormatter": "charliermarsh.ruff",
+    "jupyter.interactiveWindow.textEditor.executeSelection": true,
+    "git.autofetch": true,
+    "json.schemas": [],
+    "mcpServers": {
+        "gitlab-backend": {
+            "command": "node",
+            "args": ["/home/chka/NetBeansProjects/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/CURSOR_SETUP.md

@@ -0,0 +1,119 @@
+# 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": {
+    "gitlab-backend": {
+      "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
+
+#### Option A: VS Code Tasks (Already Configured)
+1. Press `Cmd+Shift+P` (Mac) or `Ctrl+Shift+P` (Linux/Windows)
+2. Type "Tasks: Run Task"
+3. Select either:
+   - **MCP: Create User** - Create a new GitLab/Coolify user
+   - **MCP: Init Project** - Initialize a project with deployment
+
+#### Option B: Direct MCP Commands in Chat
+Once MCP is configured, you can use these commands directly in Cursor chat:
+- `@mcp mlgym_user_create` - Create a user
+- `@mcp mlgym_project_init` - Initialize a project
+
+#### Option C: Command Line Interface
+```bash
+# Create a user
+node mcp-server/cursor-integration.js create-user
+
+# Initialize a project
+node mcp-server/cursor-integration.js init-project
+```
+
+### 3. MCP Tool Details
+
+#### mlgym_user_create
+Creates a complete user 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
+
+#### mlgym_project_init
+Initializes a project with:
+- GitLab repository creation
+- Webhook setup for CI/CD
+- Coolify deployment configuration
+- Returns deployment URL
+
+**Parameters:**
+- `name` (required): Project name
+- `description` (optional): Project description
+- `enable_deployment` (boolean): Enable Coolify deployment
+- `local_path` (optional): Local directory to initialize
+
+### 4. 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
+```
+
+### 5. Authentication
+
+MCP stores authentication tokens in `~/.mlgym/mcp_config.json` automatically after first user creation.
+
+### 6. 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
+4. Check Cursor logs for MCP errors
+
+## Quick Test
+
+1. Open Terminal in Cursor
+2. Run: `node mcp-server/cursor-integration.js create-user`
+3. Follow the prompts to create a test user
+4. Verify user was created in GitLab and Coolify
+
+## Environment Variables
+
+The MCP server uses these endpoints:
+- Backend: https://backend.eu.ezb.net
+- GitLab: https://git.mlgym.io
+- Coolify: https://coolify.eu.ezb.net
+
+These are pre-configured in the `.cursor/settings.json` file.

package/README.md

@@ -0,0 +1,43 @@
+# mlgym-deploy
+
+MCP (Model Context Protocol) server for GitLab Backend - User creation and project deployment.
+
+## Installation
+
+```bash
+npm install -g mlgym-deploy
+```
+
+## Usage
+
+### As MCP Server
+
+Configure in your MCP client settings:
+
+```json
+{
+  "mcpServers": {
+    "mlgym": {
+      "command": "npx",
+      "args": ["-y", "mlgym-deploy"]
+    }
+  }
+}
+```
+
+### Available Tools
+
+- `mlgym_user_create` - Create a new user with GitLab, Coolify, and SSH key setup
+- `mlgym_project_init` - Initialize a project with GitLab repository and Coolify deployment
+
+## Configuration
+
+Set the backend URL via environment variable:
+
+```bash
+export MLGYM_BACKEND_URL=https://backend.eu.ezb.net
+```
+
+## License
+
+MIT

package/claude-desktop-config.json

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

package/cursor-config.json

@@ -0,0 +1,13 @@
+{
+  "mcp.servers": {
+    "gitlab-backend": {
+      "command": "node",
+      "args": ["/home/chka/NetBeansProjects/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/cursor-integration.js

@@ -0,0 +1,165 @@
+#!/usr/bin/env node
+
+/**
+ * Cursor Integration for GitLab Backend MCP
+ * This script provides command-line access to MCP tools for use in Cursor
+ */
+
+import { spawn } from 'child_process';
+import readline from 'readline';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// MCP server path
+const MCP_SERVER = path.join(__dirname, 'index.js');
+
+// Create interface for user input
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout
+});
+
+// Helper to call MCP server
+async function callMCPTool(toolName, args) {
+  return new Promise((resolve, reject) => {
+    const mcp = spawn('node', [MCP_SERVER], {
+      stdio: ['pipe', 'pipe', 'pipe']
+    });
+
+    let output = '';
+    let error = '';
+
+    // Send request
+    const request = {
+      jsonrpc: '2.0',
+      method: 'tools/call',
+      params: {
+        name: toolName,
+        arguments: args
+      },
+      id: 1
+    };
+
+    mcp.stdin.write(JSON.stringify(request) + '\n');
+
+    mcp.stdout.on('data', (data) => {
+      output += data.toString();
+    });
+
+    mcp.stderr.on('data', (data) => {
+      error += data.toString();
+    });
+
+    mcp.on('close', (code) => {
+      if (code !== 0) {
+        reject(new Error(`MCP server exited with code ${code}: ${error}`));
+      } else {
+        try {
+          const response = JSON.parse(output);
+          resolve(response.result);
+        } catch (e) {
+          resolve(output);
+        }
+      }
+    });
+  });
+}
+
+// Command handlers
+const commands = {
+  'create-user': async () => {
+    console.log('\n🚀 Create GitLab Backend User\n');
+
+    const email = await question('Email: ');
+    const name = await question('Name: ');
+    const password = await question('Password: ');
+
+    console.log('\nCreating user...');
+
+    try {
+      const result = await callMCPTool('mlgym_user_create', {
+        email,
+        name,
+        password
+      });
+
+      console.log('\n✅ User created successfully!');
+      console.log(JSON.stringify(result, null, 2));
+    } catch (error) {
+      console.error('\n❌ Error:', error.message);
+    }
+  },
+
+  'init-project': async () => {
+    console.log('\n🚀 Initialize GitLab Project\n');
+
+    const name = await question('Project name: ');
+    const description = await question('Description (optional): ');
+    const enableDeployment = await question('Enable deployment? (y/n): ');
+    const localPath = await question('Local path (default: .): ') || '.';
+
+    console.log('\nInitializing project...');
+
+    try {
+      const result = await callMCPTool('mlgym_project_init', {
+        name,
+        description,
+        enable_deployment: enableDeployment.toLowerCase() === 'y',
+        local_path: localPath
+      });
+
+      console.log('\n✅ Project initialized successfully!');
+      console.log(JSON.stringify(result, null, 2));
+    } catch (error) {
+      console.error('\n❌ Error:', error.message);
+    }
+  },
+
+  'help': async () => {
+    console.log(`
+GitLab Backend MCP Tools for Cursor
+====================================
+
+Commands:
+  create-user    - Create a new GitLab/Coolify user
+  init-project   - Initialize a new project with deployment
+  help          - Show this help message
+  exit          - Exit the tool
+
+Usage:
+  node cursor-integration.js <command>
+
+Examples:
+  node cursor-integration.js create-user
+  node cursor-integration.js init-project
+`);
+  }
+};
+
+// Helper to prompt for input
+function question(prompt) {
+  return new Promise((resolve) => {
+    rl.question(prompt, resolve);
+  });
+}
+
+// Main execution
+async function main() {
+  const command = process.argv[2] || 'help';
+
+  if (command === 'exit') {
+    rl.close();
+    process.exit(0);
+  }
+
+  const handler = commands[command] || commands.help;
+  await handler();
+
+  rl.close();
+}
+
+// Run
+main().catch(console.error);

package/cursor-prompt-config.json

@@ -0,0 +1,27 @@
+{
+  "mcp_client_config": {
+    "force_explicit_prompts": true,
+    "never_assume_values": true,
+    "always_ask_user": [
+      "email",
+      "name",
+      "password",
+      "accept_terms",
+      "project_name",
+      "project_description"
+    ],
+    "validation_rules": {
+      "email": "Must be a valid email address provided by user",
+      "name": "Must be user's full name, minimum 2 characters",
+      "password": "Must be provided by user, minimum 8 characters",
+      "accept_terms": "User must explicitly type 'yes' or 'true' to accept terms",
+      "project_name": "Must be provided by user, lowercase alphanumeric with hyphens",
+      "project_description": "Must be provided by user, minimum 10 characters"
+    },
+    "error_messages": {
+      "missing_field": "This field is required and must be provided by the user",
+      "assumed_value": "Auto-detection is disabled. User must provide this value explicitly.",
+      "terms_not_accepted": "User must explicitly accept the terms and conditions"
+    }
+  }
+}

package/deploy-hello-world.sh

@@ -0,0 +1,103 @@
+#!/bin/bash
+
+# Test script to demonstrate MCP server functionality for deploying hello-world-example
+
+echo "============================================"
+echo "MCP Server Deployment Test"
+echo "Project: /home/chka/lab/hello-world-example"
+echo "============================================"
+echo
+
+# Colors for output
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Test user credentials (for demo)
+TEST_EMAIL="test-mcp-$(date +%s)@example.com"
+TEST_NAME="MCP Test User"
+TEST_PASSWORD="Test123!MCP"
+PROJECT_NAME="hello-world-mcp-$(date +%s)"
+
+echo -e "${YELLOW}Step 1: Testing MCP Server Protocol${NC}"
+echo "---------------------------------------"
+
+# Test MCP initialization
+INIT_REQUEST='{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"1.0.0","capabilities":{},"clientInfo":{"name":"deploy-test","version":"1.0.0"}},"id":1}'
+echo "$INIT_REQUEST" | node /home/chka/NetBeansProjects/gitlab_backend/mcp-server/index.js 2>/dev/null | head -1 | grep -q "gitlab-backend-mcp"
+
+if [ $? -eq 0 ]; then
+    echo -e "${GREEN}✅ MCP server initialized successfully${NC}"
+else
+    echo "❌ MCP server initialization failed"
+    exit 1
+fi
+
+echo
+echo -e "${YELLOW}Step 2: Creating User via MCP${NC}"
+echo "---------------------------------------"
+echo "Email: $TEST_EMAIL"
+echo "Name: $TEST_NAME"
+echo
+
+# Create user using MCP tool
+USER_REQUEST=$(cat <<EOF
+{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"1.0.0","capabilities":{},"clientInfo":{"name":"deploy-test","version":"1.0.0"}},"id":1}
+{"jsonrpc":"2.0","method":"tools/call","params":{"name":"mlgym_user_create","arguments":{"email":"$TEST_EMAIL","name":"$TEST_NAME","password":"$TEST_PASSWORD"}},"id":2}
+EOF
+)
+
+echo "Calling mlgym_user_create..."
+USER_RESPONSE=$(echo "$USER_REQUEST" | node /home/chka/NetBeansProjects/gitlab_backend/mcp-server/index.js 2>/dev/null | tail -1)
+
+if echo "$USER_RESPONSE" | grep -q '"content"'; then
+    echo -e "${GREEN}✅ User created successfully via MCP${NC}"
+    echo "$USER_RESPONSE" | python3 -m json.tool | head -20
+else
+    echo "❌ User creation failed"
+    echo "$USER_RESPONSE"
+fi
+
+echo
+echo -e "${YELLOW}Step 3: Initializing Project with Deployment${NC}"
+echo "---------------------------------------"
+echo "Project Name: $PROJECT_NAME"
+echo "Local Path: /home/chka/lab/hello-world-example"
+echo
+
+# Initialize project with deployment
+PROJECT_REQUEST=$(cat <<EOF
+{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"1.0.0","capabilities":{},"clientInfo":{"name":"deploy-test","version":"1.0.0"}},"id":1}
+{"jsonrpc":"2.0","method":"tools/call","params":{"name":"mlgym_project_init","arguments":{"name":"$PROJECT_NAME","description":"Hello World Example deployed via MCP","enable_deployment":true,"local_path":"/home/chka/lab/hello-world-example"}},"id":3}
+EOF
+)
+
+echo "Calling mlgym_project_init..."
+PROJECT_RESPONSE=$(echo "$PROJECT_REQUEST" | node /home/chka/NetBeansProjects/gitlab_backend/mcp-server/index.js 2>/dev/null | tail -1)
+
+if echo "$PROJECT_RESPONSE" | grep -q '"content"'; then
+    echo -e "${GREEN}✅ Project initialized with deployment via MCP${NC}"
+    echo "$PROJECT_RESPONSE" | python3 -m json.tool | head -30
+
+    # Extract deployment URL if available
+    DEPLOYMENT_URL=$(echo "$PROJECT_RESPONSE" | grep -o 'https://[^"]*' | grep -v gitlab | head -1)
+    if [ ! -z "$DEPLOYMENT_URL" ]; then
+        echo
+        echo -e "${GREEN}🚀 Deployment URL: $DEPLOYMENT_URL${NC}"
+    fi
+else
+    echo "❌ Project initialization failed"
+    echo "$PROJECT_RESPONSE"
+fi
+
+echo
+echo "============================================"
+echo "MCP Deployment Test Complete"
+echo "============================================"
+echo
+echo "To use with Claude in natural language:"
+echo "1. 'Create a user account for john@example.com'"
+echo "2. 'Deploy my hello-world project to GitLab and Coolify'"
+echo "3. 'Initialize a new project with deployment enabled'"
+echo
+echo "The MCP server translates these requests into API calls!"