@masonator/coolify-mcp 1.1.1 → 1.5.0

package/README.md

@@ -1,7 +1,16 @@
 # Coolify MCP Server
 
+[![npm version](https://img.shields.io/npm/v/@masonator/coolify-mcp.svg)](https://www.npmjs.com/package/@masonator/coolify-mcp)
+[![npm downloads](https://img.shields.io/npm/dm/@masonator/coolify-mcp.svg)](https://www.npmjs.com/package/@masonator/coolify-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/node/v/@masonator/coolify-mcp.svg)](https://nodejs.org)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.8-blue.svg)](https://www.typescriptlang.org/)
+[![CI](https://github.com/StuMason/coolify-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/StuMason/coolify-mcp/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/StuMason/coolify-mcp/branch/main/graph/badge.svg)](https://codecov.io/gh/StuMason/coolify-mcp)
 [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/stumason-coolify-mcp-badge.png)](https://mseep.ai/app/stumason-coolify-mcp)
 
+> **The most comprehensive MCP server for Coolify** - 67 tools, 7 workflow prompts, smart diagnostics, and batch operations for managing your self-hosted PaaS through AI assistants.
+
 A Model Context Protocol (MCP) server for [Coolify](https://coolify.io/), enabling AI assistants to manage and debug your Coolify instances through natural language.
 
 ## Features
@@ -297,15 +306,36 @@ Power user tools for operating on multiple resources at once:
 - `stop_all_apps` - Emergency stop all running applications (requires confirmation)
 - `redeploy_project` - Redeploy all applications in a project with force rebuild
 
+## Why Coolify MCP?
+
+- **Context-Optimized**: Responses are 90-99% smaller than raw API, preventing context window exhaustion
+- **Smart Lookup**: Find apps by domain (`stuartmason.co.uk`), servers by IP, not just UUIDs
+- **Batch Operations**: Restart entire projects, bulk update env vars, emergency stop all apps
+- **Workflow Prompts**: Pre-built guided workflows for common tasks
+- **Production Ready**: 98%+ test coverage, TypeScript strict mode, comprehensive error handling
+- **Always Current**: Weekly OpenAPI drift detection ensures we stay in sync with Coolify
+
+## Related Links
+
+- [Coolify](https://coolify.io/) - The open-source & self-hostable Heroku/Netlify/Vercel alternative
+- [Model Context Protocol](https://modelcontextprotocol.io/) - The protocol powering AI tool integrations
+- [MCP Server Registry](https://github.com/modelcontextprotocol/servers) - Official MCP server directory
+
 ## Contributing
 
-Contributions welcome! Please open an issue first to discuss major changes.
+Contributions welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
 ## License
 
-MIT
+MIT - see [LICENSE](LICENSE) for details.
 
 ## Support
 
-- [GitHub Issues](https://github.com/stumason/coolify-mcp/issues)
+- [GitHub Issues](https://github.com/StuMason/coolify-mcp/issues)
 - [Coolify Community](https://coolify.io/docs/contact)
+
+---
+
+<p align="center">
+  <strong>If you find this useful, please ⭐ star the repo!</strong>
+</p>

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

@@ -495,9 +495,9 @@ describe('CoolifyClient', () => {
         });
         it('should delete a project environment', async () => {
             mockFetch.mockResolvedValueOnce(mockResponse({ message: 'Deleted' }));
-            const result = await client.deleteProjectEnvironment('env-uuid');
+            const result = await client.deleteProjectEnvironment('project-uuid', 'env-uuid');
             expect(result).toEqual({ message: 'Deleted' });
-            expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/projects/environments/env-uuid', expect.objectContaining({ method: 'DELETE' }));
+            expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/projects/project-uuid/environments/env-uuid', expect.objectContaining({ method: 'DELETE' }));
         });
     });
     // =========================================================================

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

@@ -82,7 +82,7 @@ export declare class CoolifyClient {
     listProjectEnvironments(projectUuid: string): Promise<Environment[]>;
     getProjectEnvironment(projectUuid: string, environmentNameOrUuid: string): Promise<Environment>;
     createProjectEnvironment(projectUuid: string, data: CreateEnvironmentRequest): Promise<UuidResponse>;
-    deleteProjectEnvironment(environmentUuid: string): Promise<MessageResponse>;
+    deleteProjectEnvironment(projectUuid: string, environmentNameOrUuid: string): Promise<MessageResponse>;
     listApplications(options?: ListOptions): Promise<Application[] | ApplicationSummary[]>;
     getApplication(uuid: string): Promise<Application>;
     createApplicationPublic(data: CreateApplicationPublicRequest): Promise<UuidResponse>;

package/dist/lib/coolify-client.js

@@ -244,8 +244,8 @@ export class CoolifyClient {
             body: JSON.stringify(data),
         });
     }
-    async deleteProjectEnvironment(environmentUuid) {
-        return this.request(`/projects/environments/${environmentUuid}`, {
+    async deleteProjectEnvironment(projectUuid, environmentNameOrUuid) {
+        return this.request(`/projects/${projectUuid}/environments/${environmentNameOrUuid}`, {
             method: 'DELETE',
         });
     }

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.1.1';
+const VERSION = '1.5.0';
 /** Wrap tool handler with consistent error handling */
 function wrapHandler(fn) {
     return fn()
@@ -146,7 +146,10 @@ export class CoolifyMcpServer extends McpServer {
             name: z.string().describe('Environment name'),
             description: z.string().optional().describe('Description'),
         }, async ({ project_uuid, ...data }) => wrapHandler(() => this.client.createProjectEnvironment(project_uuid, data)));
-        this.tool('delete_environment', 'Delete an environment', { environment_uuid: z.string().describe('Environment UUID') }, async ({ environment_uuid }) => wrapHandler(() => this.client.deleteProjectEnvironment(environment_uuid)));
+        this.tool('delete_environment', 'Delete an environment. Environment must be empty (no resources).', {
+            project_uuid: z.string().describe('Project UUID'),
+            environment_name_or_uuid: z.string().describe('Environment name or UUID'),
+        }, async ({ project_uuid, environment_name_or_uuid }) => wrapHandler(() => this.client.deleteProjectEnvironment(project_uuid, environment_name_or_uuid)));
         // =========================================================================
         // Applications (15 tools)
         // =========================================================================

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@masonator/coolify-mcp",
   "scope": "@masonator",
-  "version": "1.1.1",
+  "version": "1.5.0",
   "description": "MCP server implementation for Coolify",
   "type": "module",
   "main": "./dist/index.js",