@masonator/coolify-mcp 0.2.18 → 0.3.1

package/dist/lib/coolify-client.js

@@ -0,0 +1,502 @@
+/**
+ * Coolify API Client
+ * 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.
+ */
+function cleanRequestData(data) {
+    const cleaned = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (value !== undefined && value !== false) {
+            cleaned[key] = value;
+        }
+    }
+    return cleaned;
+}
+/**
+ * HTTP client for the Coolify API
+ */
+export class CoolifyClient {
+    constructor(config) {
+        if (!config.baseUrl) {
+            throw new Error('Coolify base URL is required');
+        }
+        if (!config.accessToken) {
+            throw new Error('Coolify access token is required');
+        }
+        this.baseUrl = config.baseUrl.replace(/\/$/, '');
+        this.accessToken = config.accessToken;
+    }
+    // ===========================================================================
+    // Private HTTP methods
+    // ===========================================================================
+    async request(path, options = {}) {
+        const url = `${this.baseUrl}/api/v1${path}`;
+        try {
+            const response = await fetch(url, {
+                ...options,
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.accessToken}`,
+                    ...options.headers,
+                },
+            });
+            // Handle empty responses (204 No Content, etc.)
+            const text = await response.text();
+            const data = text ? JSON.parse(text) : {};
+            if (!response.ok) {
+                const error = data;
+                throw new Error(error.message || `HTTP ${response.status}: ${response.statusText}`);
+            }
+            return data;
+        }
+        catch (error) {
+            if (error instanceof TypeError && error.message.includes('fetch')) {
+                throw new Error(`Failed to connect to Coolify server at ${this.baseUrl}. Please check if the server is running and accessible.`);
+            }
+            throw error;
+        }
+    }
+    buildQueryString(params) {
+        const searchParams = new URLSearchParams();
+        for (const [key, value] of Object.entries(params)) {
+            if (value !== undefined && value !== null) {
+                searchParams.set(key, String(value));
+            }
+        }
+        const queryString = searchParams.toString();
+        return queryString ? `?${queryString}` : '';
+    }
+    // ===========================================================================
+    // Health & Version
+    // ===========================================================================
+    async getVersion() {
+        // The /version endpoint returns plain text, not JSON
+        const url = `${this.baseUrl}/api/v1/version`;
+        const response = await fetch(url, {
+            headers: {
+                Authorization: `Bearer ${this.accessToken}`,
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        const version = await response.text();
+        return { version: version.trim() };
+    }
+    async validateConnection() {
+        try {
+            await this.getVersion();
+        }
+        catch (error) {
+            throw new Error(`Failed to connect to Coolify server: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // ===========================================================================
+    // Server endpoints
+    // ===========================================================================
+    async listServers() {
+        return this.request('/servers');
+    }
+    async getServer(uuid) {
+        return this.request(`/servers/${uuid}`);
+    }
+    async createServer(data) {
+        return this.request('/servers', {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+    }
+    async updateServer(uuid, data) {
+        return this.request(`/servers/${uuid}`, {
+            method: 'PATCH',
+            body: JSON.stringify(data),
+        });
+    }
+    async deleteServer(uuid) {
+        return this.request(`/servers/${uuid}`, {
+            method: 'DELETE',
+        });
+    }
+    async getServerResources(uuid) {
+        return this.request(`/servers/${uuid}/resources`);
+    }
+    async getServerDomains(uuid) {
+        return this.request(`/servers/${uuid}/domains`);
+    }
+    async validateServer(uuid) {
+        return this.request(`/servers/${uuid}/validate`);
+    }
+    // ===========================================================================
+    // Project endpoints
+    // ===========================================================================
+    async listProjects() {
+        return this.request('/projects');
+    }
+    async getProject(uuid) {
+        return this.request(`/projects/${uuid}`);
+    }
+    async createProject(data) {
+        return this.request('/projects', {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+    }
+    async updateProject(uuid, data) {
+        return this.request(`/projects/${uuid}`, {
+            method: 'PATCH',
+            body: JSON.stringify(data),
+        });
+    }
+    async deleteProject(uuid) {
+        return this.request(`/projects/${uuid}`, {
+            method: 'DELETE',
+        });
+    }
+    // ===========================================================================
+    // Environment endpoints
+    // ===========================================================================
+    async listProjectEnvironments(projectUuid) {
+        return this.request(`/projects/${projectUuid}/environments`);
+    }
+    async getProjectEnvironment(projectUuid, environmentNameOrUuid) {
+        return this.request(`/projects/${projectUuid}/${environmentNameOrUuid}`);
+    }
+    async createProjectEnvironment(projectUuid, data) {
+        return this.request(`/projects/${projectUuid}/environments`, {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+    }
+    async deleteProjectEnvironment(environmentUuid) {
+        return this.request(`/projects/environments/${environmentUuid}`, {
+            method: 'DELETE',
+        });
+    }
+    // ===========================================================================
+    // Application endpoints
+    // ===========================================================================
+    async listApplications() {
+        return this.request('/applications');
+    }
+    async getApplication(uuid) {
+        return this.request(`/applications/${uuid}`);
+    }
+    async createApplicationPublic(data) {
+        return this.request('/applications/public', {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+    }
+    async createApplicationPrivateGH(data) {
+        return this.request('/applications/private-github-app', {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+    }
+    async createApplicationPrivateKey(data) {
+        return this.request('/applications/private-deploy-key', {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+    }
+    async createApplicationDockerfile(data) {
+        return this.request('/applications/dockerfile', {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+    }
+    async createApplicationDockerImage(data) {
+        return this.request('/applications/dockerimage', {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+    }
+    async createApplicationDockerCompose(data) {
+        return this.request('/applications/dockercompose', {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+    }
+    async updateApplication(uuid, data) {
+        return this.request(`/applications/${uuid}`, {
+            method: 'PATCH',
+            body: JSON.stringify(data),
+        });
+    }
+    async deleteApplication(uuid, options) {
+        const query = this.buildQueryString({
+            delete_configurations: options?.deleteConfigurations,
+            delete_volumes: options?.deleteVolumes,
+            docker_cleanup: options?.dockerCleanup,
+            delete_connected_networks: options?.deleteConnectedNetworks,
+        });
+        return this.request(`/applications/${uuid}${query}`, {
+            method: 'DELETE',
+        });
+    }
+    async getApplicationLogs(uuid, lines = 100) {
+        return this.request(`/applications/${uuid}/logs?lines=${lines}`);
+    }
+    async startApplication(uuid, options) {
+        const query = this.buildQueryString({
+            force: options?.force,
+            instant_deploy: options?.instant_deploy,
+        });
+        return this.request(`/applications/${uuid}/start${query}`, {
+            method: 'POST',
+        });
+    }
+    async stopApplication(uuid) {
+        return this.request(`/applications/${uuid}/stop`, {
+            method: 'POST',
+        });
+    }
+    async restartApplication(uuid) {
+        return this.request(`/applications/${uuid}/restart`, {
+            method: 'POST',
+        });
+    }
+    // ===========================================================================
+    // Application Environment Variables
+    // ===========================================================================
+    async listApplicationEnvVars(uuid) {
+        return this.request(`/applications/${uuid}/envs`);
+    }
+    async createApplicationEnvVar(uuid, data) {
+        return this.request(`/applications/${uuid}/envs`, {
+            method: 'POST',
+            body: JSON.stringify(cleanRequestData(data)),
+        });
+    }
+    async updateApplicationEnvVar(uuid, data) {
+        return this.request(`/applications/${uuid}/envs`, {
+            method: 'PATCH',
+            body: JSON.stringify(cleanRequestData(data)),
+        });
+    }
+    async bulkUpdateApplicationEnvVars(uuid, data) {
+        return this.request(`/applications/${uuid}/envs/bulk`, {
+            method: 'PATCH',
+            body: JSON.stringify(data),
+        });
+    }
+    async deleteApplicationEnvVar(uuid, envUuid) {
+        return this.request(`/applications/${uuid}/envs/${envUuid}`, {
+            method: 'DELETE',
+        });
+    }
+    // ===========================================================================
+    // Database endpoints
+    // ===========================================================================
+    async listDatabases() {
+        return this.request('/databases');
+    }
+    async getDatabase(uuid) {
+        return this.request(`/databases/${uuid}`);
+    }
+    async updateDatabase(uuid, data) {
+        return this.request(`/databases/${uuid}`, {
+            method: 'PATCH',
+            body: JSON.stringify(data),
+        });
+    }
+    async deleteDatabase(uuid, options) {
+        const query = this.buildQueryString({
+            delete_configurations: options?.deleteConfigurations,
+            delete_volumes: options?.deleteVolumes,
+            docker_cleanup: options?.dockerCleanup,
+            delete_connected_networks: options?.deleteConnectedNetworks,
+        });
+        return this.request(`/databases/${uuid}${query}`, {
+            method: 'DELETE',
+        });
+    }
+    async startDatabase(uuid) {
+        return this.request(`/databases/${uuid}/start`, {
+            method: 'POST',
+        });
+    }
+    async stopDatabase(uuid) {
+        return this.request(`/databases/${uuid}/stop`, {
+            method: 'POST',
+        });
+    }
+    async restartDatabase(uuid) {
+        return this.request(`/databases/${uuid}/restart`, {
+            method: 'POST',
+        });
+    }
+    // ===========================================================================
+    // 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() {
+        return this.request('/services');
+    }
+    async getService(uuid) {
+        return this.request(`/services/${uuid}`);
+    }
+    async createService(data) {
+        return this.request('/services', {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+    }
+    async updateService(uuid, data) {
+        return this.request(`/services/${uuid}`, {
+            method: 'PATCH',
+            body: JSON.stringify(data),
+        });
+    }
+    async deleteService(uuid, options) {
+        const query = this.buildQueryString({
+            delete_configurations: options?.deleteConfigurations,
+            delete_volumes: options?.deleteVolumes,
+            docker_cleanup: options?.dockerCleanup,
+            delete_connected_networks: options?.deleteConnectedNetworks,
+        });
+        return this.request(`/services/${uuid}${query}`, {
+            method: 'DELETE',
+        });
+    }
+    async startService(uuid) {
+        return this.request(`/services/${uuid}/start`, {
+            method: 'GET',
+        });
+    }
+    async stopService(uuid) {
+        return this.request(`/services/${uuid}/stop`, {
+            method: 'GET',
+        });
+    }
+    async restartService(uuid) {
+        return this.request(`/services/${uuid}/restart`, {
+            method: 'GET',
+        });
+    }
+    // ===========================================================================
+    // Service Environment Variables
+    // ===========================================================================
+    async listServiceEnvVars(uuid) {
+        return this.request(`/services/${uuid}/envs`);
+    }
+    async createServiceEnvVar(uuid, data) {
+        return this.request(`/services/${uuid}/envs`, {
+            method: 'POST',
+            body: JSON.stringify(cleanRequestData(data)),
+        });
+    }
+    async updateServiceEnvVar(uuid, data) {
+        return this.request(`/services/${uuid}/envs`, {
+            method: 'PATCH',
+            body: JSON.stringify(cleanRequestData(data)),
+        });
+    }
+    async deleteServiceEnvVar(uuid, envUuid) {
+        return this.request(`/services/${uuid}/envs/${envUuid}`, {
+            method: 'DELETE',
+        });
+    }
+    // ===========================================================================
+    // Deployment endpoints
+    // ===========================================================================
+    async listDeployments() {
+        return this.request('/deployments');
+    }
+    async getDeployment(uuid) {
+        return this.request(`/deployments/${uuid}`);
+    }
+    async deployByTagOrUuid(tagOrUuid, force = false) {
+        return this.request(`/deploy?tag=${encodeURIComponent(tagOrUuid)}&force=${force}`, { method: 'GET' });
+    }
+    async listApplicationDeployments(appUuid) {
+        return this.request(`/applications/${appUuid}/deployments`);
+    }
+    // ===========================================================================
+    // Team endpoints
+    // ===========================================================================
+    async listTeams() {
+        return this.request('/teams');
+    }
+    async getTeam(id) {
+        return this.request(`/teams/${id}`);
+    }
+    async getTeamMembers(id) {
+        return this.request(`/teams/${id}/members`);
+    }
+    async getCurrentTeam() {
+        return this.request('/teams/current');
+    }
+    async getCurrentTeamMembers() {
+        return this.request('/teams/current/members');
+    }
+    // ===========================================================================
+    // Private Key endpoints
+    // ===========================================================================
+    async listPrivateKeys() {
+        return this.request('/security/keys');
+    }
+    async getPrivateKey(uuid) {
+        return this.request(`/security/keys/${uuid}`);
+    }
+    async createPrivateKey(data) {
+        return this.request('/security/keys', {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+    }
+    async updatePrivateKey(uuid, data) {
+        return this.request(`/security/keys/${uuid}`, {
+            method: 'PATCH',
+            body: JSON.stringify(data),
+        });
+    }
+    async deletePrivateKey(uuid) {
+        return this.request(`/security/keys/${uuid}`, {
+            method: 'DELETE',
+        });
+    }
+    // ===========================================================================
+    // Cloud Token endpoints (Hetzner, DigitalOcean)
+    // ===========================================================================
+    async listCloudTokens() {
+        return this.request('/cloud-tokens');
+    }
+    async getCloudToken(uuid) {
+        return this.request(`/cloud-tokens/${uuid}`);
+    }
+    async createCloudToken(data) {
+        return this.request('/cloud-tokens', {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+    }
+    async updateCloudToken(uuid, data) {
+        return this.request(`/cloud-tokens/${uuid}`, {
+            method: 'PATCH',
+            body: JSON.stringify(data),
+        });
+    }
+    async deleteCloudToken(uuid) {
+        return this.request(`/cloud-tokens/${uuid}`, {
+            method: 'DELETE',
+        });
+    }
+    async validateCloudToken(uuid) {
+        return this.request(`/cloud-tokens/${uuid}/validate`, { method: 'POST' });
+    }
+}

package/dist/lib/mcp-server.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Coolify MCP Server
+ * Model Context Protocol server for Coolify API
+ *
+ * Tools focused on debugging, management, and deployment:
+ * - Servers: list, get, validate, resources, domains
+ * - Projects: CRUD
+ * - Environments: CRUD
+ * - Applications: list, get, update, delete, start/stop/restart, logs, env vars, deploy (private-gh, private-key)
+ * - Databases: list, get, start/stop/restart
+ * - Services: list, get, update, start/stop/restart, env vars
+ * - Deployments: list, get, deploy
+ *
+ * Note: @ts-nocheck is required because the MCP SDK's tool() method causes
+ * TypeScript type instantiation depth errors with 40+ zod-typed tools.
+ * The client and types are still fully type-checked.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+import type { CoolifyConfig } from '../types/coolify.js';
+/**
+ * Coolify MCP Server
+ */
+export declare class CoolifyMcpServer extends McpServer {
+    private readonly client;
+    constructor(config: CoolifyConfig);
+    connect(transport: Transport): Promise<void>;
+    private registerTools;
+}