@masonator/coolify-mcp 0.6.0 → 0.7.0

package/README.md

@@ -6,7 +6,7 @@ A Model Context Protocol (MCP) server for [Coolify](https://coolify.io/), enabli
 
 ## Features
 
-This MCP server provides 47 tools focused on **debugging, management, and deployment**:
+This MCP server provides **58 tools** focused on **debugging, management, and deployment**:
 
 | Category           | Tools                                                                                                    |
 | ------------------ | -------------------------------------------------------------------------------------------------------- |
@@ -15,9 +15,10 @@ This MCP server provides 47 tools focused on **debugging, management, and deploy
 | **Projects**       | list, get, create, update, delete                                                                        |
 | **Environments**   | list, get, create, delete                                                                                |
 | **Applications**   | list, get, update, delete, start, stop, restart, logs, env vars (CRUD), create (private-gh, private-key) |
-| **Databases**      | list, get, start, stop, restart                                                                          |
+| **Databases**      | list, get, start, stop, restart, backups (list, get), backup executions (list, get)                      |
 | **Services**       | list, get, create, update, delete, start, stop, restart, env vars (list, create, delete)                 |
-| **Deployments**    | list, get, deploy, list by application                                                                   |
+| **Deployments**    | list, get, deploy, cancel, list by application                                                           |
+| **Private Keys**   | list, get, create, update, delete                                                                        |
 
 ## Installation
 
@@ -222,6 +223,10 @@ node dist/index.js
 - `start_database` - Start a database
 - `stop_database` - Stop a database
 - `restart_database` - Restart a database
+- `list_database_backups` - List scheduled backups for a database
+- `get_database_backup` - Get details of a scheduled backup
+- `list_backup_executions` - List execution history for a scheduled backup
+- `get_backup_execution` - Get details of a specific backup execution
 
 ### Services
 
@@ -242,8 +247,17 @@ node dist/index.js
 - `list_deployments` - List running deployments (returns summary)
 - `get_deployment` - Get deployment details
 - `deploy` - Deploy by tag or UUID
+- `cancel_deployment` - Cancel a running deployment
 - `list_application_deployments` - List deployments for an application
 
+### Private Keys
+
+- `list_private_keys` - List all private keys (SSH keys for deployments)
+- `get_private_key` - Get private key details
+- `create_private_key` - Create a new private key for deployments
+- `update_private_key` - Update a private key
+- `delete_private_key` - Delete a private key
+
 ## Contributing
 
 Contributions welcome! Please open an issue first to discuss major changes.

package/dist/__tests__/coolify-client.test.js

@@ -745,14 +745,26 @@ describe('CoolifyClient', () => {
             expect(result).toEqual(mockBackups);
             expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/databases/db-uuid/backups', expect.any(Object));
         });
-        it('should create a database backup', async () => {
-            mockFetch.mockResolvedValueOnce(mockResponse({ uuid: 'new-backup-uuid', message: 'Backup created' }));
-            const result = await client.createDatabaseBackup('db-uuid', {
-                frequency: 'daily',
-                backup_retention: 7,
-            });
-            expect(result).toEqual({ uuid: 'new-backup-uuid', message: 'Backup created' });
-            expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/databases/db-uuid/backups', expect.objectContaining({ method: 'POST' }));
+        it('should get a database backup', async () => {
+            const mockBackup = { uuid: 'backup-uuid', enabled: true, frequency: '0 0 * * *' };
+            mockFetch.mockResolvedValueOnce(mockResponse(mockBackup));
+            const result = await client.getDatabaseBackup('db-uuid', 'backup-uuid');
+            expect(result).toEqual(mockBackup);
+            expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/databases/db-uuid/backups/backup-uuid', expect.any(Object));
+        });
+        it('should list backup executions', async () => {
+            const mockExecutions = [{ uuid: 'exec-uuid', status: 'success' }];
+            mockFetch.mockResolvedValueOnce(mockResponse(mockExecutions));
+            const result = await client.listBackupExecutions('db-uuid', 'backup-uuid');
+            expect(result).toEqual(mockExecutions);
+            expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/databases/db-uuid/backups/backup-uuid/executions', expect.any(Object));
+        });
+        it('should get a backup execution', async () => {
+            const mockExecution = { uuid: 'exec-uuid', status: 'success', size: 1024 };
+            mockFetch.mockResolvedValueOnce(mockResponse(mockExecution));
+            const result = await client.getBackupExecution('db-uuid', 'backup-uuid', 'exec-uuid');
+            expect(result).toEqual(mockExecution);
+            expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/databases/db-uuid/backups/backup-uuid/executions/exec-uuid', expect.any(Object));
         });
     });
     // =========================================================================
@@ -1022,4 +1034,71 @@ describe('CoolifyClient', () => {
             expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/deploy?tag=my-tag&force=false', expect.any(Object));
         });
     });
+    // ===========================================================================
+    // Database Backup Tests
+    // ===========================================================================
+    describe('Database Backups', () => {
+        const mockBackups = [
+            {
+                id: 1,
+                uuid: 'backup-uuid-1',
+                database_id: 1,
+                database_type: 'postgresql',
+                database_uuid: 'db-uuid',
+                enabled: true,
+                frequency: '0 0 * * *',
+                save_s3: false,
+                created_at: '2024-01-01',
+                updated_at: '2024-01-01',
+            },
+        ];
+        const mockExecutions = [
+            {
+                id: 1,
+                uuid: 'exec-uuid-1',
+                scheduled_database_backup_id: 1,
+                status: 'success',
+                message: 'Backup completed',
+                size: 1024,
+                filename: 'backup-20240101.sql',
+                created_at: '2024-01-01',
+                updated_at: '2024-01-01',
+            },
+        ];
+        it('should list database backups', async () => {
+            mockFetch.mockResolvedValueOnce(mockResponse(mockBackups));
+            const result = await client.listDatabaseBackups('db-uuid');
+            expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/databases/db-uuid/backups', expect.any(Object));
+            expect(result).toEqual(mockBackups);
+        });
+        it('should get a specific database backup', async () => {
+            mockFetch.mockResolvedValueOnce(mockResponse(mockBackups[0]));
+            const result = await client.getDatabaseBackup('db-uuid', 'backup-uuid-1');
+            expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/databases/db-uuid/backups/backup-uuid-1', expect.any(Object));
+            expect(result).toEqual(mockBackups[0]);
+        });
+        it('should list backup executions', async () => {
+            mockFetch.mockResolvedValueOnce(mockResponse(mockExecutions));
+            const result = await client.listBackupExecutions('db-uuid', 'backup-uuid-1');
+            expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/databases/db-uuid/backups/backup-uuid-1/executions', expect.any(Object));
+            expect(result).toEqual(mockExecutions);
+        });
+        it('should get a specific backup execution', async () => {
+            mockFetch.mockResolvedValueOnce(mockResponse(mockExecutions[0]));
+            const result = await client.getBackupExecution('db-uuid', 'backup-uuid-1', 'exec-uuid-1');
+            expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/databases/db-uuid/backups/backup-uuid-1/executions/exec-uuid-1', expect.any(Object));
+            expect(result).toEqual(mockExecutions[0]);
+        });
+    });
+    // ===========================================================================
+    // Deployment Control Tests
+    // ===========================================================================
+    describe('Deployment Control', () => {
+        it('should cancel a deployment', async () => {
+            mockFetch.mockResolvedValueOnce(mockResponse({ message: 'Deployment cancelled' }));
+            const result = await client.cancelDeployment('deploy-uuid');
+            expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/deployments/deploy-uuid/cancel', expect.objectContaining({ method: 'POST' }));
+            expect(result).toEqual({ message: 'Deployment cancelled' });
+        });
+    });
 });

package/dist/lib/coolify-client.d.ts

@@ -2,7 +2,7 @@
  * Coolify API Client
  * Complete HTTP client for the Coolify API v1
  */
-import type { CoolifyConfig, DeleteOptions, MessageResponse, UuidResponse, Server, ServerResource, ServerDomain, ServerValidation, CreateServerRequest, UpdateServerRequest, Project, CreateProjectRequest, UpdateProjectRequest, Environment, CreateEnvironmentRequest, Application, CreateApplicationPublicRequest, CreateApplicationPrivateGHRequest, CreateApplicationPrivateKeyRequest, CreateApplicationDockerfileRequest, CreateApplicationDockerImageRequest, CreateApplicationDockerComposeRequest, UpdateApplicationRequest, ApplicationActionResponse, EnvironmentVariable, CreateEnvVarRequest, UpdateEnvVarRequest, BulkUpdateEnvVarsRequest, Database, UpdateDatabaseRequest, DatabaseBackup, CreateDatabaseBackupRequest, Service, CreateServiceRequest, UpdateServiceRequest, ServiceCreateResponse, Deployment, Team, TeamMember, PrivateKey, CreatePrivateKeyRequest, UpdatePrivateKeyRequest, CloudToken, CreateCloudTokenRequest, UpdateCloudTokenRequest, CloudTokenValidation, Version } from '../types/coolify.js';
+import type { CoolifyConfig, DeleteOptions, MessageResponse, UuidResponse, Server, ServerResource, ServerDomain, ServerValidation, CreateServerRequest, UpdateServerRequest, Project, CreateProjectRequest, UpdateProjectRequest, Environment, CreateEnvironmentRequest, Application, CreateApplicationPublicRequest, CreateApplicationPrivateGHRequest, CreateApplicationPrivateKeyRequest, CreateApplicationDockerfileRequest, CreateApplicationDockerImageRequest, CreateApplicationDockerComposeRequest, UpdateApplicationRequest, ApplicationActionResponse, EnvironmentVariable, CreateEnvVarRequest, UpdateEnvVarRequest, BulkUpdateEnvVarsRequest, Database, UpdateDatabaseRequest, DatabaseBackup, BackupExecution, Service, CreateServiceRequest, UpdateServiceRequest, ServiceCreateResponse, Deployment, Team, TeamMember, PrivateKey, CreatePrivateKeyRequest, UpdatePrivateKeyRequest, CloudToken, CreateCloudTokenRequest, UpdateCloudTokenRequest, CloudTokenValidation, Version } from '../types/coolify.js';
 export interface ListOptions {
     page?: number;
     per_page?: number;
@@ -112,8 +112,6 @@ export declare class CoolifyClient {
     startDatabase(uuid: string): Promise<MessageResponse>;
     stopDatabase(uuid: string): Promise<MessageResponse>;
     restartDatabase(uuid: string): Promise<MessageResponse>;
-    listDatabaseBackups(uuid: string): Promise<DatabaseBackup[]>;
-    createDatabaseBackup(uuid: string, data: CreateDatabaseBackupRequest): Promise<UuidResponse & MessageResponse>;
     listServices(options?: ListOptions): Promise<Service[] | ServiceSummary[]>;
     getService(uuid: string): Promise<Service>;
     createService(data: CreateServiceRequest): Promise<ServiceCreateResponse>;
@@ -146,4 +144,9 @@ export declare class CoolifyClient {
     updateCloudToken(uuid: string, data: UpdateCloudTokenRequest): Promise<CloudToken>;
     deleteCloudToken(uuid: string): Promise<MessageResponse>;
     validateCloudToken(uuid: string): Promise<CloudTokenValidation>;
+    listDatabaseBackups(databaseUuid: string): Promise<DatabaseBackup[]>;
+    getDatabaseBackup(databaseUuid: string, backupUuid: string): Promise<DatabaseBackup>;
+    listBackupExecutions(databaseUuid: string, backupUuid: string): Promise<BackupExecution[]>;
+    getBackupExecution(databaseUuid: string, backupUuid: string, executionUuid: string): Promise<BackupExecution>;
+    cancelDeployment(uuid: string): Promise<MessageResponse>;
 }

package/dist/lib/coolify-client.js

@@ -3,13 +3,13 @@
  * Complete HTTP client for the Coolify API v1
  */
 /**
- * Remove undefined values and false booleans from an object.
- * Coolify API rejects requests with explicit false values for optional booleans.
+ * Remove undefined values from an object.
+ * Keeps explicit false values so features like HTTP Basic Auth can be disabled.
  */
 function cleanRequestData(data) {
     const cleaned = {};
     for (const [key, value] of Object.entries(data)) {
-        if (value !== undefined && value !== false) {
+        if (value !== undefined) {
             cleaned[key] = value;
         }
     }
@@ -406,18 +406,6 @@ export class CoolifyClient {
         });
     }
     // ===========================================================================
-    // Database Backups
-    // ===========================================================================
-    async listDatabaseBackups(uuid) {
-        return this.request(`/databases/${uuid}/backups`);
-    }
-    async createDatabaseBackup(uuid, data) {
-        return this.request(`/databases/${uuid}/backups`, {
-            method: 'POST',
-            body: JSON.stringify(data),
-        });
-    }
-    // ===========================================================================
     // Service endpoints
     // ===========================================================================
     async listServices(options) {
@@ -587,4 +575,27 @@ export class CoolifyClient {
     async validateCloudToken(uuid) {
         return this.request(`/cloud-tokens/${uuid}/validate`, { method: 'POST' });
     }
+    // ===========================================================================
+    // Database Backup endpoints
+    // ===========================================================================
+    async listDatabaseBackups(databaseUuid) {
+        return this.request(`/databases/${databaseUuid}/backups`);
+    }
+    async getDatabaseBackup(databaseUuid, backupUuid) {
+        return this.request(`/databases/${databaseUuid}/backups/${backupUuid}`);
+    }
+    async listBackupExecutions(databaseUuid, backupUuid) {
+        return this.request(`/databases/${databaseUuid}/backups/${backupUuid}/executions`);
+    }
+    async getBackupExecution(databaseUuid, backupUuid, executionUuid) {
+        return this.request(`/databases/${databaseUuid}/backups/${backupUuid}/executions/${executionUuid}`);
+    }
+    // ===========================================================================
+    // Deployment Control endpoints
+    // ===========================================================================
+    async cancelDeployment(uuid) {
+        return this.request(`/deployments/${uuid}/cancel`, {
+            method: 'POST',
+        });
+    }
 }

package/dist/lib/mcp-server.js

@@ -20,7 +20,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
 import { CoolifyClient, } from './coolify-client.js';
-const VERSION = '0.6.0';
+const VERSION = '0.7.0';
 /** Wrap tool handler with consistent error handling */
 function wrapHandler(fn) {
     return fn()
@@ -306,5 +306,40 @@ export class CoolifyMcpServer extends McpServer {
             force: z.boolean().optional().describe('Force rebuild'),
         }, async ({ tag_or_uuid, force }) => wrapHandler(() => this.client.deployByTagOrUuid(tag_or_uuid, force)));
         this.tool('list_application_deployments', 'List deployments for an application', { uuid: z.string().describe('Application UUID') }, async ({ uuid }) => wrapHandler(() => this.client.listApplicationDeployments(uuid)));
+        this.tool('cancel_deployment', 'Cancel a running deployment', { uuid: z.string().describe('Deployment UUID') }, async ({ uuid }) => wrapHandler(() => this.client.cancelDeployment(uuid)));
+        // =========================================================================
+        // Private Keys (5 tools)
+        // =========================================================================
+        this.tool('list_private_keys', 'List all private keys (SSH keys for deployments)', {}, async () => wrapHandler(() => this.client.listPrivateKeys()));
+        this.tool('get_private_key', 'Get private key details', { uuid: z.string().describe('Private key UUID') }, async ({ uuid }) => wrapHandler(() => this.client.getPrivateKey(uuid)));
+        this.tool('create_private_key', 'Create a new private key for deployments', {
+            private_key: z.string().describe('The private key content (PEM format)'),
+            name: z.string().optional().describe('Name for the key'),
+            description: z.string().optional().describe('Description'),
+        }, async (args) => wrapHandler(() => this.client.createPrivateKey(args)));
+        this.tool('update_private_key', 'Update a private key', {
+            uuid: z.string().describe('Private key UUID'),
+            name: z.string().optional().describe('Name for the key'),
+            description: z.string().optional().describe('Description'),
+            private_key: z.string().optional().describe('The private key content (PEM format)'),
+        }, async ({ uuid, ...data }) => wrapHandler(() => this.client.updatePrivateKey(uuid, data)));
+        this.tool('delete_private_key', 'Delete a private key', { uuid: z.string().describe('Private key UUID') }, async ({ uuid }) => wrapHandler(() => this.client.deletePrivateKey(uuid)));
+        // =========================================================================
+        // Database Backups (4 tools)
+        // =========================================================================
+        this.tool('list_database_backups', 'List scheduled backups for a database', { uuid: z.string().describe('Database UUID') }, async ({ uuid }) => wrapHandler(() => this.client.listDatabaseBackups(uuid)));
+        this.tool('get_database_backup', 'Get details of a scheduled backup', {
+            database_uuid: z.string().describe('Database UUID'),
+            backup_uuid: z.string().describe('Scheduled backup UUID'),
+        }, async ({ database_uuid, backup_uuid }) => wrapHandler(() => this.client.getDatabaseBackup(database_uuid, backup_uuid)));
+        this.tool('list_backup_executions', 'List execution history for a scheduled backup', {
+            database_uuid: z.string().describe('Database UUID'),
+            backup_uuid: z.string().describe('Scheduled backup UUID'),
+        }, async ({ database_uuid, backup_uuid }) => wrapHandler(() => this.client.listBackupExecutions(database_uuid, backup_uuid)));
+        this.tool('get_backup_execution', 'Get details of a specific backup execution', {
+            database_uuid: z.string().describe('Database UUID'),
+            backup_uuid: z.string().describe('Scheduled backup UUID'),
+            execution_uuid: z.string().describe('Backup execution UUID'),
+        }, async ({ database_uuid, backup_uuid, execution_uuid }) => wrapHandler(() => this.client.getBackupExecution(database_uuid, backup_uuid, execution_uuid)));
     }
 }

package/dist/types/coolify.d.ts

@@ -300,6 +300,9 @@ export interface UpdateApplicationRequest {
     limits_memory?: string;
     limits_memory_swap?: string;
     limits_cpus?: string;
+    is_http_basic_auth_enabled?: boolean;
+    http_basic_auth_username?: string;
+    http_basic_auth_password?: string;
 }
 export interface ApplicationActionResponse {
     message: string;
@@ -470,6 +473,17 @@ export interface CreateDatabaseBackupRequest {
     backup_retention?: number;
     backup_retention_days?: number;
 }
+export interface BackupExecution {
+    id: number;
+    uuid: string;
+    scheduled_database_backup_id: number;
+    status: 'pending' | 'running' | 'success' | 'failed';
+    message?: string;
+    size?: number;
+    filename?: string;
+    created_at: string;
+    updated_at: string;
+}
 /**
  * Available one-click service types in Coolify.
  * This is a string type to avoid TypeScript memory issues with large const arrays.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@masonator/coolify-mcp",
   "scope": "@masonator",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "MCP server implementation for Coolify",
   "type": "module",
   "main": "./dist/index.js",
@@ -61,5 +61,9 @@
   },
   "engines": {
     "node": ">=18"
+  },
+  "lint-staged": {
+    "*.{ts,js,json,md,yaml,yml}": "prettier --write",
+    "*.ts": "eslint --fix"
   }
 }