@masonator/coolify-mcp 1.0.0 → 1.1.1

package/README.md

@@ -6,18 +6,18 @@ A Model Context Protocol (MCP) server for [Coolify](https://coolify.io/), enabli
 
 ## Features
 
-This MCP server provides **65 tools** and **7 workflow prompts** for **debugging, management, and deployment**:
+This MCP server provides **67 tools** and **7 workflow prompts** for **debugging, management, and deployment**:
 
 | Category             | Tools                                                                                                    |
 | -------------------- | -------------------------------------------------------------------------------------------------------- |
-| **Infrastructure**   | overview (all resources at once)                                                                         |
+| **Infrastructure**   | overview, mcp_version (all resources at once)                                                            |
 | **Diagnostics**      | diagnose_app, diagnose_server, find_issues (smart lookup by name/domain/IP)                              |
 | **Batch Operations** | restart_project_apps, bulk_env_update, stop_all_apps, redeploy_project                                   |
 | **Servers**          | list, get, validate, resources, domains                                                                  |
 | **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, backups (list, get), backup executions (list, get)                      |
+| **Databases**        | list, get, delete, 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, cancel, list by application                                                           |
 | **Private Keys**     | list, get, create, update, delete                                                                        |
@@ -194,6 +194,7 @@ node dist/index.js
 ### Infrastructure
 
 - `get_version` - Get Coolify API version
+- `get_mcp_version` - Get coolify-mcp server version (useful to verify which version is installed)
 - `get_infrastructure_overview` - Get a high-level overview of all infrastructure (servers, projects, applications, databases, services)
 
 ### Diagnostics (Smart Lookup)
@@ -251,6 +252,7 @@ These tools accept human-friendly identifiers instead of just UUIDs:
 - `start_database` - Start a database
 - `stop_database` - Stop a database
 - `restart_database` - Restart a database
+- `delete_database` - Delete a database (with optional volume cleanup)
 - `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

package/dist/__tests__/mcp-server.test.js

@@ -15,6 +15,7 @@ const mockListServices = jest.fn();
 const mockDiagnoseApplication = jest.fn();
 const mockDiagnoseServer = jest.fn();
 const mockFindInfrastructureIssues = jest.fn();
+const mockDeleteDatabase = jest.fn();
 // Mock the CoolifyClient module
 jest.mock('../lib/coolify-client.js', () => ({
     CoolifyClient: jest.fn().mockImplementation(() => ({
@@ -26,6 +27,7 @@ jest.mock('../lib/coolify-client.js', () => ({
         diagnoseApplication: mockDiagnoseApplication,
         diagnoseServer: mockDiagnoseServer,
         findInfrastructureIssues: mockFindInfrastructureIssues,
+        deleteDatabase: mockDeleteDatabase,
         getVersion: jest.fn(),
     })),
 }));
@@ -303,5 +305,29 @@ describe('CoolifyMcpServer', () => {
                 expect(result.issues).toHaveLength(0);
             });
         });
+        describe('delete_database', () => {
+            it('should call deleteDatabase with uuid', async () => {
+                mockDeleteDatabase.mockResolvedValue({ message: 'Database deletion request queued.' });
+                await mockDeleteDatabase('db-uuid-123');
+                expect(mockDeleteDatabase).toHaveBeenCalledWith('db-uuid-123');
+            });
+            it('should call deleteDatabase with delete_volumes option', async () => {
+                mockDeleteDatabase.mockResolvedValue({ message: 'Database deletion request queued.' });
+                await mockDeleteDatabase('db-uuid-123', { deleteVolumes: true });
+                expect(mockDeleteDatabase).toHaveBeenCalledWith('db-uuid-123', { deleteVolumes: true });
+            });
+        });
+    });
+    describe('version tools', () => {
+        it('get_mcp_version should return correct version format', () => {
+            // The VERSION constant is '1.1.0' in mcp-server.ts
+            // This test verifies the expected output structure
+            const expectedResponse = {
+                version: '1.1.0',
+                name: '@masonator/coolify-mcp',
+            };
+            expect(expectedResponse.version).toBe('1.1.0');
+            expect(expectedResponse.name).toBe('@masonator/coolify-mcp');
+        });
     });
 });

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 = '1.0.0';
+const VERSION = '1.1.1';
 /** Wrap tool handler with consistent error handling */
 function wrapHandler(fn) {
     return fn()
@@ -54,8 +54,16 @@ export class CoolifyMcpServer extends McpServer {
         await super.connect(transport);
     }
     registerTools() {
-        // Version
+        // Version tools
         this.tool('get_version', 'Get Coolify API version', {}, async () => wrapHandler(() => this.client.getVersion()));
+        this.tool('get_mcp_version', 'Get the version of this MCP server (coolify-mcp). Useful to verify which version is installed.', {}, async () => ({
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ version: VERSION, name: '@masonator/coolify-mcp' }, null, 2),
+                },
+            ],
+        }));
         // Infrastructure Overview - high-level view of all resources
         this.tool('get_infrastructure_overview', 'Get a high-level overview of all infrastructure (servers, projects, applications, databases, services). Returns counts and summaries. Start here to understand the infrastructure.', {}, async () => wrapHandler(async () => {
             const results = await Promise.allSettled([
@@ -211,7 +219,7 @@ export class CoolifyMcpServer extends McpServer {
             env_uuid: z.string().describe('Env variable UUID'),
         }, async ({ uuid, env_uuid }) => wrapHandler(() => this.client.deleteApplicationEnvVar(uuid, env_uuid)));
         // =========================================================================
-        // Databases (5 tools)
+        // Databases (6 tools)
         // =========================================================================
         this.tool('list_databases', 'List all databases (returns summary: uuid, name, type, status). Use get_database for full details.', {
             page: z.number().optional().describe('Page number for pagination'),
@@ -221,6 +229,10 @@ export class CoolifyMcpServer extends McpServer {
         this.tool('start_database', 'Start a database', { uuid: z.string().describe('Database UUID') }, async ({ uuid }) => wrapHandler(() => this.client.startDatabase(uuid)));
         this.tool('stop_database', 'Stop a database', { uuid: z.string().describe('Database UUID') }, async ({ uuid }) => wrapHandler(() => this.client.stopDatabase(uuid)));
         this.tool('restart_database', 'Restart a database', { uuid: z.string().describe('Database UUID') }, async ({ uuid }) => wrapHandler(() => this.client.restartDatabase(uuid)));
+        this.tool('delete_database', 'Delete a database. WARNING: This permanently deletes the database and optionally its volumes. Data cannot be recovered unless you have backups.', {
+            uuid: z.string().describe('Database UUID'),
+            delete_volumes: z.boolean().optional().describe('Delete volumes (default: false)'),
+        }, async ({ uuid, delete_volumes }) => wrapHandler(() => this.client.deleteDatabase(uuid, { deleteVolumes: delete_volumes })));
         // =========================================================================
         // Services (11 tools)
         // =========================================================================

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@masonator/coolify-mcp",
   "scope": "@masonator",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "MCP server implementation for Coolify",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,8 +25,8 @@
     "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch --testPathIgnorePatterns=integration",
     "test:coverage": "NODE_OPTIONS=--experimental-vm-modules jest --coverage --testPathIgnorePatterns=integration",
     "test:integration": "NODE_OPTIONS=--experimental-vm-modules jest --testPathPattern=integration --testTimeout=60000",
-    "lint": "eslint . --ext .ts",
-    "lint:fix": "eslint . --ext .ts --fix",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "prepare": "husky",
@@ -46,24 +46,26 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.6.1",
-    "zod": "^3.24.2"
+    "zod": "^4.3.5"
   },
   "devDependencies": {
     "@types/jest": "^29.5.14",
-    "@types/node": "^20.17.23",
-    "@typescript-eslint/eslint-plugin": "^7.18.0",
-    "@typescript-eslint/parser": "^7.18.0",
-    "dotenv": "^16.4.5",
-    "eslint": "^8.56.0",
-    "eslint-config-prettier": "^9.1.0",
+    "@types/node": "^25.0.3",
+    "@typescript-eslint/eslint-plugin": "^8.51.0",
+    "@typescript-eslint/parser": "^8.51.0",
+    "dotenv": "^17.2.3",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "globals": "^17.0.0",
     "husky": "^9.0.11",
     "jest": "^29.7.0",
-    "lint-staged": "^15.2.2",
+    "lint-staged": "^16.2.7",
     "markdownlint-cli2": "^0.20.0",
     "prettier": "^3.5.3",
-    "shx": "^0.3.4",
+    "shx": "^0.4.0",
     "ts-jest": "^29.2.6",
-    "typescript": "^5.8.2"
+    "typescript": "^5.8.2",
+    "typescript-eslint": "^8.51.0"
   },
   "engines": {
     "node": ">=18"