@172ai/containers-mcp-server 1.12.6 → 1.12.7

package/README.md

@@ -37,6 +37,14 @@ containers-mcp-server
 - **Get Build Status**: Monitor build progress and status
 - **List Builds**: View build history for containers
 - **Get Build Logs**: Access detailed build logs and output
+- **Explain Build Logs**: Get AI-powered analysis and explanations of build failures
+
+### Container Fix Management
+- **Fix Container**: Automatically analyze build failures, apply AI-generated fixes, and rebuild (primary workflow)
+- **Analyze Container Failure**: Analyze build/execution failures without auto-applying fixes (for review workflows)
+- **Approve and Apply Fix**: Apply a specific fix attempt after reviewing analysis results
+- **Get Fix History**: View all fix attempts for a container with their outcomes
+- **Get Fix Status**: Get detailed status and information about a specific fix attempt
 
 ### File Management
 - **List Container Files**: Browse files within containers
@@ -174,6 +182,14 @@ Once connected, you can use these tools in your AI conversations:
 - `build_container` - Start container builds
 - `get_build_status` - Check build progress
 - `list_builds` - View build history
+- `explain_build_logs` - Get AI analysis of build failures
+
+#### Fix Operations
+- `fix_container` - Auto-analyze, fix, and rebuild failed containers
+- `analyze_container_failure` - Analyze failures without auto-applying fixes
+- `approve_and_apply_fix` - Apply a specific fix after review
+- `get_fix_history` - View all fix attempts for a container
+- `get_fix_status` - Get details of a specific fix attempt
 
 #### Execution Operations
 - `start_execution` - Deploy and run containers
@@ -205,6 +221,30 @@ await getContainer({ containerId: 'container-123' });
 // Build a container
 await buildContainer({ containerId: 'container-123' });
 
+// Fix a failed container automatically
+await fixContainer({
+  containerId: 'container-123',
+  autoApply: true,
+  progressToken: 'fix-progress-123'
+});
+
+// Analyze failure without auto-applying
+const analysis = await analyzeContainerFailure({
+  containerId: 'container-123'
+});
+
+// Review and approve a specific fix
+await approveAndApplyFix({
+  containerId: 'container-123',
+  fixAttemptId: analysis.fixAttemptId
+});
+
+// View fix history
+await getFixHistory({
+  containerId: 'container-123',
+  limit: 10
+});
+
 // Deploy and run a container
 await startExecution({ 
   containerId: 'container-123', 
@@ -252,6 +292,29 @@ await uploadFile({
 
 #### `build_container`
 - `containerId`: Container ID to build
+- `progressToken`: Optional token for real-time progress notifications
+
+#### `fix_container`
+- `containerId`: Container ID to fix
+- `autoApply`: Auto-apply fix after analysis (default: true)
+- `progressToken`: Optional token for real-time progress notifications
+
+#### `analyze_container_failure`
+- `containerId`: Container ID to analyze
+- `progressToken`: Optional token for progress notifications
+
+#### `approve_and_apply_fix`
+- `containerId`: Container ID
+- `fixAttemptId`: Fix attempt ID from analysis result
+- `progressToken`: Optional token for progress notifications
+
+#### `get_fix_history`
+- `containerId`: Container ID
+- `limit`: Maximum number of fix attempts to return (default: 10)
+
+#### `get_fix_status`
+- `containerId`: Container ID
+- `fixAttemptId`: Fix attempt ID to retrieve
 
 #### `upload_file`
 - `containerId`: Target container ID

package/dist/server.d.ts

@@ -17,6 +17,10 @@ declare class ContainerMCPServer {
      * Set up all available tools
      */
     private setupTools;
+    /**
+     * Set up container fix management tools
+     */
+    private setupFixTools;
     /**
      * Set up container management tools
      */
@@ -62,6 +66,11 @@ declare class ContainerMCPServer {
     private handleExplainBuildLogs;
     private handleCancelBuildMonitoring;
     private handleGetStreamAnalytics;
+    private handleFixContainer;
+    private handleAnalyzeContainerFailure;
+    private handleApproveAndApplyFix;
+    private handleGetFixHistory;
+    private handleGetFixStatus;
     private handleImportContainer;
     private handleGetImportStatus;
     private handleListImportJobs;

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AA8BA;;;;;GAKG;AACH,cAAM,kBAAkB;IACtB,OAAO,CAAC,MAAM,CAAS;;IAsBvB;;;OAGG;YACW,mBAAmB;IAwCjC;;OAEG;IACH,OAAO,CAAC,UAAU;IAiBlB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAmL3B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAkFnC;;OAEG;IACH,OAAO,CAAC,WAAW;IAo4CnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;YAoBZ,oBAAoB;YAmBpB,kBAAkB;YAmElB,qBAAqB;YAiCrB,qBAAqB;YAcrB,qBAAqB;YAYrB,mBAAmB;YAcnB,oBAAoB;YAkBpB,oBAAoB;YAmBpB,gBAAgB;YAmBhB,kBAAkB;YAclB,sBAAsB;YAgCtB,2BAA2B;YAc3B,wBAAwB;YA0CxB,qBAAqB;YAsBrB,qBAAqB;YAoCrB,oBAAoB;YAmCpB,4BAA4B;YAc5B,8BAA8B;YA0C9B,qBAAqB;YAsBrB,qBAAqB;YAqDrB,oBAAoB;YAoCpB,0BAA0B;YAiB1B,qBAAqB;YAgBrB,4BAA4B;YAc5B,8BAA8B;YAyC9B,6BAA6B;YA6B7B,wBAAwB;YAkBxB,oBAAoB;YAiBpB,gBAAgB;YAgBhB,gBAAgB;YAgBhB,gBAAgB;YAYhB,sBAAsB;YAmBtB,mBAAmB;YAmBnB,wBAAwB;YAkBxB,oBAAoB;YAqBpB,mBAAmB;YAcnB,wBAAwB;YA6BxB,oBAAoB;YAwBpB,0BAA0B;YAmB1B,sBAAsB;YAsCtB,wBAAwB;YA+BxB,2BAA2B;YA8B3B,qBAAqB;YAcrB,yBAAyB;YAuBzB,qBAAqB;YAyBrB,8BAA8B;YAwB9B,yBAAyB;YA0CzB,+BAA+B;YAc/B,iCAAiC;IAyC/C;;OAEG;YACW,4BAA4B;IAkC1C;;OAEG;YACW,gCAAgC;IAkC9C;;OAEG;YACW,2BAA2B;IAwCzC;;OAEG;YACW,uBAAuB;IAoCrC;;OAEG;YACW,mCAAmC;IAsCjD;;OAEG;YACW,gCAAgC;IA0B9C;;OAEG;YACW,2BAA2B;IAgBzC;;OAEG;YACW,8BAA8B;IA8B5C;;OAEG;IACH,OAAO,CAAC,sCAAsC;IAwG9C;;OAEG;IACH,OAAO,CAAC,oCAAoC;IAgG5C;;OAEG;IACH,OAAO,CAAC,qCAAqC;IA8H7C;;OAEG;IACH,OAAO,CAAC,gCAAgC;IAwLxC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8B5B;;OAEG;YACW,QAAQ;CAkBvB;AAID,OAAO,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AA+BA;;;;;GAKG;AACH,cAAM,kBAAkB;IACtB,OAAO,CAAC,MAAM,CAAS;;IAuBvB;;;OAGG;YACW,mBAAmB;IAwCjC;;OAEG;IACH,OAAO,CAAC,UAAU;IAoBlB;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA6L3B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAkFnC;;OAEG;IACH,OAAO,CAAC,WAAW;IA4+CnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;YAoBZ,oBAAoB;YAmBpB,kBAAkB;YAmElB,qBAAqB;YAiCrB,qBAAqB;YAcrB,qBAAqB;YAYrB,mBAAmB;YAcnB,oBAAoB;YAkBpB,oBAAoB;YAmBpB,gBAAgB;YAmBhB,kBAAkB;YAclB,sBAAsB;YAgCtB,2BAA2B;YAc3B,wBAAwB;YA0CxB,kBAAkB;YAwBlB,6BAA6B;YA2B7B,wBAAwB;YAuBxB,mBAAmB;YA0CnB,kBAAkB;YA6ClB,qBAAqB;YAsBrB,qBAAqB;YAoCrB,oBAAoB;YAmCpB,4BAA4B;YAc5B,8BAA8B;YA0C9B,qBAAqB;YAsBrB,qBAAqB;YAqDrB,oBAAoB;YAoCpB,0BAA0B;YAiB1B,qBAAqB;YAgBrB,4BAA4B;YAc5B,8BAA8B;YAyC9B,6BAA6B;YA6B7B,wBAAwB;YAkBxB,oBAAoB;YAiBpB,gBAAgB;YAgBhB,gBAAgB;YAgBhB,gBAAgB;YAYhB,sBAAsB;YAmBtB,mBAAmB;YAmBnB,wBAAwB;YAkBxB,oBAAoB;YAqBpB,mBAAmB;YAcnB,wBAAwB;YA6BxB,oBAAoB;YAwBpB,0BAA0B;YAmB1B,sBAAsB;YAsCtB,wBAAwB;YA+BxB,2BAA2B;YA8B3B,qBAAqB;YAcrB,yBAAyB;YAuBzB,qBAAqB;YAyBrB,8BAA8B;YAwB9B,yBAAyB;YA0CzB,+BAA+B;YAc/B,iCAAiC;IAyC/C;;OAEG;YACW,4BAA4B;IAkC1C;;OAEG;YACW,gCAAgC;IAkC9C;;OAEG;YACW,2BAA2B;IAwCzC;;OAEG;YACW,uBAAuB;IAoCrC;;OAEG;YACW,mCAAmC;IAsCjD;;OAEG;YACW,gCAAgC;IA0B9C;;OAEG;YACW,2BAA2B;IAgBzC;;OAEG;YACW,8BAA8B;IA8B5C;;OAEG;IACH,OAAO,CAAC,sCAAsC;IAwG9C;;OAEG;IACH,OAAO,CAAC,oCAAoC;IAgG5C;;OAEG;IACH,OAAO,CAAC,qCAAqC;IA8H7C;;OAEG;IACH,OAAO,CAAC,gCAAgC;IAwLxC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8B5B;;OAEG;YACW,QAAQ;CAkBvB;AAID,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/server.js

@@ -7,6 +7,7 @@ import { config } from './config.js';
 import { authManager } from './auth.js';
 import { containerService } from './services/containerService.js';
 import { buildService } from './services/buildService.js';
+import { fixService } from './services/fixService.js';
 import { fileService } from './services/fileService.js';
 import { capabilityService } from './services/capabilityService.js';
 import { executionService } from './services/executionService.js';
@@ -31,6 +32,7 @@ class ContainerMCPServer {
         });
         // Initialize MCP server reference for progress notifications
         buildService.setMCPServer(this.server);
+        fixService.setMCPServer(this.server);
         executionService.setMCPServer(this.server);
         importService.setMCPServer(this.server);
         exportService.setMCPServer(this.server);
@@ -85,6 +87,8 @@ class ContainerMCPServer {
         this.setupContainerTools();
         // Build Management Tools
         this.setupBuildTools();
+        // Fix Management Tools
+        this.setupFixTools();
         // File Management Tools
         this.setupFileTools();
         // Capability Management Tools
@@ -92,6 +96,13 @@ class ContainerMCPServer {
         // Execution Management Tools
         this.setupExecutionTools();
     }
+    /**
+     * Set up container fix management tools
+     */
+    setupFixTools() {
+        // Fix tools are registered via CallToolRequestSchema handler
+        // No separate setup needed - they share the same request handler
+    }
     /**
      * Set up container management tools
      */
@@ -160,6 +171,16 @@ class ContainerMCPServer {
                         return await this.handleCancelBuildMonitoring(args);
                     case 'get_stream_analytics':
                         return await this.handleGetStreamAnalytics(args);
+                    case 'fix_container':
+                        return await this.handleFixContainer(args);
+                    case 'analyze_container_failure':
+                        return await this.handleAnalyzeContainerFailure(args);
+                    case 'approve_and_apply_fix':
+                        return await this.handleApproveAndApplyFix(args);
+                    case 'get_fix_history':
+                        return await this.handleGetFixHistory(args);
+                    case 'get_fix_status':
+                        return await this.handleGetFixStatus(args);
                     case 'import_container':
                         return await this.handleImportContainer(args);
                     case 'get_import_status':
@@ -777,6 +798,109 @@ Follow same metadata requirements as create_container.`,
                     }
                 }
             },
+            // Fix Management Tools
+            {
+                name: 'fix_container',
+                description: 'Analyze container build failure, apply AI-generated fix, and rebuild automatically. This is the primary fix workflow that combines analysis, application, and rebuild into one operation.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        containerId: {
+                            type: 'string',
+                            description: 'ID of the container to fix'
+                        },
+                        autoApply: {
+                            type: 'boolean',
+                            description: 'Whether to automatically apply the fix after analysis (default: true). Set to false for analyze-only mode.',
+                            default: true
+                        },
+                        progressToken: {
+                            type: 'string',
+                            description: 'Optional token for receiving real-time progress notifications during fix operation'
+                        }
+                    },
+                    required: ['containerId']
+                }
+            },
+            {
+                name: 'analyze_container_failure',
+                description: 'Analyze container build/execution failure and generate fix suggestions WITHOUT automatically applying them. Returns fixAttemptId for later approval.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        containerId: {
+                            type: 'string',
+                            description: 'ID of the container to analyze'
+                        },
+                        progressToken: {
+                            type: 'string',
+                            description: 'Optional token for receiving real-time progress notifications'
+                        }
+                    },
+                    required: ['containerId']
+                }
+            },
+            {
+                name: 'approve_and_apply_fix',
+                description: 'Apply a specific fix attempt and trigger automatic rebuild. Use this after reviewing analysis results from analyze_container_failure.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        containerId: {
+                            type: 'string',
+                            description: 'ID of the container'
+                        },
+                        fixAttemptId: {
+                            type: 'string',
+                            description: 'ID of the fix attempt to apply (from analyze_container_failure result)'
+                        },
+                        progressToken: {
+                            type: 'string',
+                            description: 'Optional token for receiving real-time progress notifications'
+                        }
+                    },
+                    required: ['containerId', 'fixAttemptId']
+                }
+            },
+            {
+                name: 'get_fix_history',
+                description: 'Get the history of fix attempts for a container, showing all previous fixes and their outcomes',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        containerId: {
+                            type: 'string',
+                            description: 'ID of the container'
+                        },
+                        limit: {
+                            type: 'number',
+                            minimum: 1,
+                            maximum: 100,
+                            description: 'Maximum number of fix attempts to return (default: 10)',
+                            default: 10
+                        }
+                    },
+                    required: ['containerId']
+                }
+            },
+            {
+                name: 'get_fix_status',
+                description: 'Get detailed status and information about a specific fix attempt',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        containerId: {
+                            type: 'string',
+                            description: 'ID of the container'
+                        },
+                        fixAttemptId: {
+                            type: 'string',
+                            description: 'ID of the fix attempt to retrieve'
+                        }
+                    },
+                    required: ['containerId', 'fixAttemptId']
+                }
+            },
             // Import Management Tools
             {
                 name: 'import_container',
@@ -2075,6 +2199,151 @@ Follow same metadata requirements as create_container.`,
             ],
         };
     }
+    // Fix handler methods
+    async handleFixContainer(args) {
+        const { progressToken, autoApply = true, ...fixParams } = args;
+        const result = await fixService.fixContainer({
+            containerId: args.containerId,
+            autoApply,
+            progressToken
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `🔧 Fix operation ${autoApply ? 'started' : 'analyzed'} for container ${args.containerId}!\n\n` +
+                        `Fix Attempt ID: ${result.fixAttemptId}\n` +
+                        `Status: ${autoApply ? 'Applying fix and rebuilding' : 'Analysis complete - awaiting approval'}\n` +
+                        `Message: ${result.message}\n` +
+                        `${result.analysis ? `\nDiagnostic: ${result.analysis.diagnosticSummary}\nRoot Cause: ${result.analysis.rootCause}\n` : ''}` +
+                        `${result.buildStatus ? `Build Status: ${result.buildStatus}\n` : ''}` +
+                        `${progressToken ? `\n🔄 Progress updates will be sent via notifications using token: ${progressToken}` : ''}`,
+                },
+            ],
+        };
+    }
+    async handleAnalyzeContainerFailure(args) {
+        const { progressToken } = args;
+        const result = await fixService.analyzeFailure({
+            containerId: args.containerId,
+            progressToken
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `**Container Failure Analysis**\n\n` +
+                        `Fix Attempt ID: ${result.fixAttemptId}\n` +
+                        `Attempt: ${result.attemptNumber} of ${result.maxAttempts}\n` +
+                        `Previous Attempts: ${result.previousAttempts}\n\n` +
+                        `**Diagnostic Summary**\n${result.diagnosticSummary}\n\n` +
+                        `**Root Cause**\n${result.rootCause}\n\n` +
+                        `**Proposed Fix**\n${result.fixApproach}\n\n` +
+                        `**Severity**: ${result.severity}\n` +
+                        `**Fix Confidence**: ${result.fixConfidence}\n` +
+                        `**Affected Files**: ${result.affectedFiles.join(', ')}\n\n` +
+                        `💡 Use approve_and_apply_fix with fixAttemptId: ${result.fixAttemptId} to apply this fix`,
+                },
+            ],
+        };
+    }
+    async handleApproveAndApplyFix(args) {
+        const { progressToken } = args;
+        const result = await fixService.applyFix({
+            containerId: args.containerId,
+            fixAttemptId: args.fixAttemptId,
+            progressToken
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `✅ Fix approved and applied!\n\n` +
+                        `Fix Attempt ID: ${result.fixAttemptId}\n` +
+                        `Container ID: ${result.containerId}\n` +
+                        `Message: ${result.message}\n` +
+                        `Build Status: ${result.buildStatus}\n` +
+                        `${progressToken ? `\n🔄 Progress updates will be sent via notifications using token: ${progressToken}` : ''}`,
+                },
+            ],
+        };
+    }
+    async handleGetFixHistory(args) {
+        const result = await fixService.getFixHistory({
+            containerId: args.containerId,
+            limit: args.limit || 10
+        });
+        if (result.fixes.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `No fix attempts found for container ${args.containerId}`,
+                    },
+                ],
+            };
+        }
+        let historyText = `**Fix History for Container ${args.containerId}**\n\n` +
+            `Found ${result.totalCount} fix attempt(s):\n\n`;
+        result.fixes.forEach((fix, index) => {
+            historyText += `${index + 1}. **Fix ${fix.id}**\n` +
+                `   • Attempt Number: ${fix.attemptNumber}\n` +
+                `   • Status: ${fix.status}\n` +
+                `   • Severity: ${fix.severity}\n` +
+                `   • Confidence: ${fix.fixConfidence}\n` +
+                `   • Created: ${fix.createdAt}\n` +
+                `   ${fix.appliedAt ? `• Applied: ${fix.appliedAt}\n` : ''}` +
+                `   ${fix.completedAt ? `• Completed: ${fix.completedAt}\n` : ''}` +
+                `   ${fix.errorMessage ? `• Error: ${fix.errorMessage}\n` : ''}\n`;
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: historyText,
+                },
+            ],
+        };
+    }
+    async handleGetFixStatus(args) {
+        const result = await fixService.getFixStatus({
+            containerId: args.containerId,
+            fixAttemptId: args.fixAttemptId
+        });
+        let statusText = `**Fix Attempt Status**\n\n` +
+            `Fix ID: ${result.id}\n` +
+            `Container ID: ${result.containerId}\n` +
+            `Attempt Number: ${result.attemptNumber}\n` +
+            `Status: ${result.status}\n` +
+            `Severity: ${result.severity}\n` +
+            `Fix Confidence: ${result.fixConfidence}\n\n` +
+            `**Diagnostic Summary**\n${result.diagnosticSummary}\n\n` +
+            `**Root Cause**\n${result.rootCause}\n\n` +
+            `**Fix Approach**\n${result.fixApproach}\n\n` +
+            `**Timeline**\n` +
+            `• Created: ${result.createdAt}\n` +
+            `${result.updatedAt ? `• Updated: ${result.updatedAt}\n` : ''}` +
+            `${result.appliedAt ? `• Applied: ${result.appliedAt}\n` : ''}` +
+            `${result.completedAt ? `• Completed: ${result.completedAt}\n` : ''}`;
+        if (result.fileChanges && result.fileChanges.length > 0) {
+            statusText += `\n**File Changes (${result.fileChanges.length})**\n`;
+            result.fileChanges.forEach((change, index) => {
+                statusText += `${index + 1}. ${change.filePath} (${change.changeType})\n` +
+                    `   Reason: ${change.changeReason}\n`;
+            });
+        }
+        if (result.errorMessage) {
+            statusText += `\n❌ **Error**: ${result.errorMessage}\n`;
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: statusText,
+                },
+            ],
+        };
+    }
     // Import handler methods
     async handleImportContainer(args) {
         const { progressToken, ...importParams } = args;