@serenichron/mcp-cloudron 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Serenichron
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,189 @@
+# mcp-cloudron
+
+MCP server for [Cloudron](https://cloudron.io) instance management. List apps, get status, and manage your self-hosted applications through the Model Context Protocol.
+
+## Features
+
+- **List Applications**: Get all installed apps with status, health, and memory usage
+- **Get App Details**: Retrieve detailed information about specific applications
+- **Instance Status**: Check Cloudron version, provider, and configuration
+
+## Installation
+
+```bash
+npm install @serenichron/mcp-cloudron
+```
+
+Or run directly with npx:
+
+```bash
+npx @serenichron/mcp-cloudron
+```
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `CLOUDRON_BASE_URL` | Yes | Your Cloudron instance URL (e.g., `https://my.cloudron.io`) |
+| `CLOUDRON_API_TOKEN` | Yes | API token from Cloudron Admin Panel |
+
+### Getting an API Token
+
+1. Log in to your Cloudron Admin Panel
+2. Go to **Settings → API Tokens**
+3. Click **Create API Token**
+4. Give it a name (e.g., "MCP Server")
+5. Copy the generated token
+
+## Usage with Claude Desktop
+
+Add to your Claude Desktop configuration (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "cloudron": {
+      "command": "npx",
+      "args": ["@serenichron/mcp-cloudron"],
+      "env": {
+        "CLOUDRON_BASE_URL": "https://your-cloudron-instance.com",
+        "CLOUDRON_API_TOKEN": "your-api-token"
+      }
+    }
+  }
+}
+```
+
+## Usage with Docker MCP Gateway
+
+Add to your Docker MCP config (`~/.docker/mcp/config.yaml`):
+
+```yaml
+mcpServers:
+  cloudron:
+    command: npx
+    args: ["@serenichron/mcp-cloudron"]
+    env:
+      CLOUDRON_BASE_URL: "https://your-cloudron-instance.com"
+      CLOUDRON_API_TOKEN: "your-api-token"
+```
+
+## Available Tools
+
+### cloudron_list_apps
+
+List all installed applications on the Cloudron instance.
+
+**Parameters**: None
+
+**Returns**: List of apps with name, domain, ID, state, health, and memory usage.
+
+**Example output**:
+```
+Found 3 apps:
+
+WordPress (blog.example.com)
+  ID: abc123-def456
+  State: installed
+  Health: healthy
+  Memory: 512 MB
+
+GitLab (git.example.com)
+  ID: xyz789-uvw012
+  State: installed
+  Health: healthy
+  Memory: 4096 MB
+```
+
+### cloudron_get_app
+
+Get detailed information about a specific application.
+
+**Parameters**:
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `appId` | string | Yes | The unique identifier of the application |
+
+**Returns**: App details including name, domain, state, health, and memory.
+
+### cloudron_get_status
+
+Get the current status and configuration of the Cloudron instance.
+
+**Parameters**: None
+
+**Returns**: Instance information including name, version, admin URL, provider, and demo mode status.
+
+**Example output**:
+```
+Cloudron Status:
+  Name: My Cloudron
+  Version: 9.0.13
+  Admin URL: my.cloudron.io
+  Provider: digitalocean
+  Demo Mode: false
+```
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/serenichron/mcp-cloudron.git
+cd mcp-cloudron
+npm install
+```
+
+### Build
+
+```bash
+npm run build
+```
+
+### Run locally
+
+```bash
+export CLOUDRON_BASE_URL="https://your-instance.com"
+export CLOUDRON_API_TOKEN="your-token"
+npm start
+```
+
+### Test
+
+```bash
+npm test
+```
+
+## API Reference
+
+The server uses the [Cloudron REST API](https://docs.cloudron.io/api/). Currently implemented endpoints:
+
+- `GET /api/v1/apps` - List all applications
+- `GET /api/v1/apps/:id` - Get application by ID
+- `GET /api/v1/cloudron/status` - Get instance status
+
+## Roadmap
+
+Future versions may include:
+
+- [ ] App lifecycle management (start, stop, restart)
+- [ ] Backup operations
+- [ ] User management
+- [ ] Domain configuration
+- [ ] App installation from App Store
+
+## License
+
+MIT - See [LICENSE](LICENSE) for details.
+
+## Contributing
+
+Contributions welcome! Please open an issue or submit a pull request.
+
+## Related
+
+- [Cloudron Documentation](https://docs.cloudron.io/)
+- [Model Context Protocol](https://modelcontextprotocol.io/)
+- [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)

package/dist/cloudron-client.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Cloudron API Client
+ * MVP scope: listApps + getApp endpoints
+ * DI-enabled for testing
+ */
+import type { CloudronClientConfig, App, SystemStatus } from './types.js';
+export declare class CloudronClient {
+    private readonly baseUrl;
+    private readonly token;
+    /**
+     * Create CloudronClient with DI support
+     * @param config - Optional config (defaults to env vars)
+     */
+    constructor(config?: Partial<CloudronClientConfig>);
+    /**
+     * Make HTTP request to Cloudron API
+     * NO retry logic (deferred to Phase 3 with idempotency keys)
+     */
+    private makeRequest;
+    /**
+     * List all installed apps
+     * GET /api/v1/apps
+     */
+    listApps(): Promise<App[]>;
+    /**
+     * Get a specific app by ID
+     * GET /api/v1/apps/:appId
+     *
+     * Note: API returns app object directly, not wrapped in { app: {...} }
+     */
+    getApp(appId: string): Promise<App>;
+    /**
+     * Get Cloudron system status
+     * GET /api/v1/cloudron/status
+     */
+    getStatus(): Promise<SystemStatus>;
+}
+//# sourceMappingURL=cloudron-client.d.ts.map

package/dist/cloudron-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudron-client.d.ts","sourceRoot":"","sources":["../src/cloudron-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,GAAG,EAA6B,YAAY,EAAE,MAAM,YAAY,CAAC;AAKrG,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B;;;OAGG;gBACS,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAelD;;;OAGG;YACW,WAAW;IAiEzB;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAKhC;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAOzC;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC;CAGzC"}

package/dist/cloudron-client.js

@@ -0,0 +1,109 @@
+/**
+ * Cloudron API Client
+ * MVP scope: listApps + getApp endpoints
+ * DI-enabled for testing
+ */
+import { CloudronError, CloudronAuthError, createErrorFromStatus } from './errors.js';
+const DEFAULT_TIMEOUT = 30000;
+export class CloudronClient {
+    baseUrl;
+    token;
+    /**
+     * Create CloudronClient with DI support
+     * @param config - Optional config (defaults to env vars)
+     */
+    constructor(config) {
+        const baseUrl = config?.baseUrl ?? process.env.CLOUDRON_BASE_URL;
+        const token = config?.token ?? process.env.CLOUDRON_API_TOKEN;
+        if (!baseUrl) {
+            throw new CloudronError('CLOUDRON_BASE_URL not set. Provide via config or environment variable.');
+        }
+        if (!token) {
+            throw new CloudronError('CLOUDRON_API_TOKEN not set. Provide via config or environment variable.');
+        }
+        this.baseUrl = baseUrl.replace(/\/$/, ''); // Remove trailing slash
+        this.token = token;
+    }
+    /**
+     * Make HTTP request to Cloudron API
+     * NO retry logic (deferred to Phase 3 with idempotency keys)
+     */
+    async makeRequest(method, endpoint, body, options) {
+        const url = `${this.baseUrl}${endpoint}`;
+        const timeout = options?.timeout ?? DEFAULT_TIMEOUT;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        try {
+            const fetchOptions = {
+                method,
+                headers: {
+                    'Authorization': `Bearer ${this.token}`,
+                    'Content-Type': 'application/json',
+                    'Accept': 'application/json',
+                },
+                signal: controller.signal,
+            };
+            if (body !== undefined) {
+                fetchOptions.body = JSON.stringify(body);
+            }
+            const response = await fetch(url, fetchOptions);
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                const errorBody = await response.text();
+                let message = `Cloudron API error: ${response.status} ${response.statusText}`;
+                try {
+                    const parsed = JSON.parse(errorBody);
+                    if (parsed.message)
+                        message = parsed.message;
+                }
+                catch {
+                    // Use default message if body isn't JSON
+                }
+                throw createErrorFromStatus(response.status, message);
+            }
+            return await response.json();
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof CloudronError) {
+                throw error;
+            }
+            if (error instanceof Error) {
+                if (error.name === 'AbortError') {
+                    throw new CloudronError(`Request timeout after ${timeout}ms`, undefined, 'TIMEOUT');
+                }
+                throw new CloudronError(`Network error: ${error.message}`, undefined, 'NETWORK_ERROR');
+            }
+            throw new CloudronError('Unknown error occurred');
+        }
+    }
+    // ==================== MVP Endpoints ====================
+    /**
+     * List all installed apps
+     * GET /api/v1/apps
+     */
+    async listApps() {
+        const response = await this.makeRequest('GET', '/api/v1/apps');
+        return response.apps;
+    }
+    /**
+     * Get a specific app by ID
+     * GET /api/v1/apps/:appId
+     *
+     * Note: API returns app object directly, not wrapped in { app: {...} }
+     */
+    async getApp(appId) {
+        if (!appId) {
+            throw new CloudronError('appId is required');
+        }
+        return await this.makeRequest('GET', `/api/v1/apps/${encodeURIComponent(appId)}`);
+    }
+    /**
+     * Get Cloudron system status
+     * GET /api/v1/cloudron/status
+     */
+    async getStatus() {
+        return await this.makeRequest('GET', '/api/v1/cloudron/status');
+    }
+}
+//# sourceMappingURL=cloudron-client.js.map

package/dist/cloudron-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudron-client.js","sourceRoot":"","sources":["../src/cloudron-client.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Cloudron Error Classes
+ * MVP scope: Base error + Auth error only
+ */
+/** Base error for all Cloudron API errors */
+export declare class CloudronError extends Error {
+    readonly statusCode: number | undefined;
+    readonly code: string | undefined;
+    constructor(message: string, statusCode?: number, code?: string);
+    /**
+     * Check if error is retryable (for future Phase 3)
+     * 429 (rate limit) and 5xx errors are retryable
+     * 4xx errors (except 429) are NOT retryable
+     */
+    isRetryable(): boolean;
+}
+/** Authentication/Authorization error (401/403) */
+export declare class CloudronAuthError extends CloudronError {
+    constructor(message?: string, statusCode?: number);
+}
+/**
+ * Type guard for CloudronError
+ * Usage: if (isCloudronError(error)) { ... }
+ */
+export declare function isCloudronError(error: unknown): error is CloudronError;
+/**
+ * Create appropriate error from HTTP status code
+ * Routes 401/403 to CloudronAuthError, others to CloudronError
+ */
+export declare function createErrorFromStatus(statusCode: number, message: string): CloudronError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6CAA6C;AAC7C,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAgB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,SAAgB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE7B,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;IAY/D;;;;OAIG;IACH,WAAW,IAAI,OAAO;CAIvB;AAED,mDAAmD;AACnD,qBAAa,iBAAkB,SAAQ,aAAa;gBAEhD,OAAO,SAAqD,EAC5D,UAAU,SAAM;CAKnB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,aAAa,CAKf"}

package/dist/errors.js

@@ -0,0 +1,54 @@
+/**
+ * Cloudron Error Classes
+ * MVP scope: Base error + Auth error only
+ */
+/** Base error for all Cloudron API errors */
+export class CloudronError extends Error {
+    statusCode;
+    code;
+    constructor(message, statusCode, code) {
+        super(message);
+        this.name = 'CloudronError';
+        this.statusCode = statusCode ?? undefined;
+        this.code = code ?? undefined;
+        // Maintains proper stack trace in V8 engines
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, CloudronError);
+        }
+    }
+    /**
+     * Check if error is retryable (for future Phase 3)
+     * 429 (rate limit) and 5xx errors are retryable
+     * 4xx errors (except 429) are NOT retryable
+     */
+    isRetryable() {
+        if (!this.statusCode)
+            return false;
+        return this.statusCode === 429 || this.statusCode >= 500;
+    }
+}
+/** Authentication/Authorization error (401/403) */
+export class CloudronAuthError extends CloudronError {
+    constructor(message = 'Authentication failed. Check CLOUDRON_API_TOKEN.', statusCode = 401) {
+        super(message, statusCode, 'AUTH_ERROR');
+        this.name = 'CloudronAuthError';
+    }
+}
+/**
+ * Type guard for CloudronError
+ * Usage: if (isCloudronError(error)) { ... }
+ */
+export function isCloudronError(error) {
+    return error instanceof CloudronError;
+}
+/**
+ * Create appropriate error from HTTP status code
+ * Routes 401/403 to CloudronAuthError, others to CloudronError
+ */
+export function createErrorFromStatus(statusCode, message) {
+    if (statusCode === 401 || statusCode === 403) {
+        return new CloudronAuthError(message, statusCode);
+    }
+    return new CloudronError(message, statusCode);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6CAA6C;AAC7C,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtB,UAAU,CAAqB;IAC/B,IAAI,CAAqB;IAEzC,YAAY,OAAe,EAAE,UAAmB,EAAE,IAAa;QAC7D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,IAAI,SAAS,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,SAAS,CAAC;QAE9B,6CAA6C;QAC7C,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QACnC,OAAO,IAAI,CAAC,UAAU,KAAK,GAAG,IAAI,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC;IAC3D,CAAC;CACF;AAED,mDAAmD;AACnD,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAClD,YACE,OAAO,GAAG,kDAAkD,EAC5D,UAAU,GAAG,GAAG;QAEhB,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,YAAY,aAAa,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAkB,EAClB,OAAe;IAEf,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;QAC7C,OAAO,IAAI,iBAAiB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,IAAI,aAAa,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AAChD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Cloudron MCP Client
+ * MVP Phase 2 Implementation
+ */
+export { CloudronClient } from './cloudron-client.js';
+export type { CloudronClientConfig, App, AppManifest, AppsResponse, AppResponse, SystemStatus, } from './types.js';
+export { CloudronError, CloudronAuthError, isCloudronError, createErrorFromStatus, } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,YAAY,EACV,oBAAoB,EACpB,GAAG,EACH,WAAW,EACX,YAAY,EACZ,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,qBAAqB,GACtB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * Cloudron MCP Client
+ * MVP Phase 2 Implementation
+ */
+// Main client
+export { CloudronClient } from './cloudron-client.js';
+// Errors
+export { CloudronError, CloudronAuthError, isCloudronError, createErrorFromStatus, } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc;AACd,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAYtD,SAAS;AACT,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,qBAAqB,GACtB,MAAM,aAAa,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Cloudron MCP Server
+ * Provides tools for managing Cloudron instances via MCP protocol
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/server.js

@@ -0,0 +1,151 @@
+#!/usr/bin/env node
+/**
+ * Cloudron MCP Server
+ * Provides tools for managing Cloudron instances via MCP protocol
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { CloudronClient } from './cloudron-client.js';
+import { isCloudronError } from './errors.js';
+// Tool definitions
+const TOOLS = [
+    {
+        name: 'cloudron_list_apps',
+        description: 'List all installed applications on the Cloudron instance. Returns app details including name, domain, status, and health.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: 'cloudron_get_app',
+        description: 'Get detailed information about a specific application by its ID.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                appId: {
+                    type: 'string',
+                    description: 'The unique identifier of the application',
+                },
+            },
+            required: ['appId'],
+        },
+    },
+    {
+        name: 'cloudron_get_status',
+        description: 'Get the current status and configuration of the Cloudron instance.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+];
+// Create server instance
+const server = new Server({
+    name: 'cloudron-mcp',
+    version: '0.1.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Lazy-initialize client (validates env vars on first use)
+let client = null;
+function getClient() {
+    if (!client) {
+        client = new CloudronClient();
+    }
+    return client;
+}
+// Format app for display
+function formatApp(app) {
+    const fqdn = app.location ? `${app.location}.${app.domain}` : app.domain;
+    return `${app.manifest.title} (${fqdn})
+  ID: ${app.id}
+  State: ${app.installationState}
+  Health: ${app.health ?? 'unknown'}
+  Memory: ${Math.round(app.memoryLimit / 1024 / 1024)} MB`;
+}
+// Handle list tools request
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: TOOLS,
+}));
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        const cloudron = getClient();
+        switch (name) {
+            case 'cloudron_list_apps': {
+                const apps = await cloudron.listApps();
+                const formatted = apps.map(formatApp).join('\n\n');
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Found ${apps.length} apps:\n\n${formatted}`,
+                        },
+                    ],
+                };
+            }
+            case 'cloudron_get_app': {
+                const appId = args.appId;
+                const app = await cloudron.getApp(appId);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: formatApp(app),
+                        },
+                    ],
+                };
+            }
+            case 'cloudron_get_status': {
+                const status = await cloudron.getStatus();
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Cloudron Status:
+  Name: ${status.cloudronName}
+  Version: ${status.version}
+  Admin URL: ${status.adminFqdn}
+  Provider: ${status.provider}
+  Demo Mode: ${status.isDemo}`,
+                        },
+                    ],
+                };
+            }
+            default:
+                return {
+                    content: [{ type: 'text', text: `Unknown tool: ${name}` }],
+                    isError: true,
+                };
+        }
+    }
+    catch (error) {
+        const message = isCloudronError(error)
+            ? `Cloudron API Error: ${error.message} (${error.statusCode ?? 'unknown'})`
+            : error instanceof Error
+                ? error.message
+                : 'Unknown error occurred';
+        return {
+            content: [{ type: 'text', text: message }],
+            isError: true,
+        };
+    }
+});
+// Main entry point
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('Cloudron MCP server running on stdio');
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Integration Test for CloudronClient
+ * Tests against real Cloudron instance
+ */
+export {};
+//# sourceMappingURL=test.d.ts.map

package/dist/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../src/test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/test.js

@@ -0,0 +1,90 @@
+/**
+ * Integration Test for CloudronClient
+ * Tests against real Cloudron instance
+ */
+import { CloudronClient, CloudronError, isCloudronError } from './index.js';
+async function runTests() {
+    console.log('=== Cloudron MCP Client Integration Test ===\n');
+    // Check environment variables
+    const baseUrl = process.env.CLOUDRON_BASE_URL;
+    const token = process.env.CLOUDRON_API_TOKEN;
+    if (!baseUrl || !token) {
+        console.error('❌ Missing environment variables:');
+        if (!baseUrl)
+            console.error('   - CLOUDRON_BASE_URL not set');
+        if (!token)
+            console.error('   - CLOUDRON_API_TOKEN not set');
+        console.error('\nSet these variables and run again.');
+        process.exit(1);
+    }
+    console.log(`📡 Connecting to: ${baseUrl}\n`);
+    try {
+        // Create client
+        const client = new CloudronClient();
+        console.log('✅ Client created successfully\n');
+        // Test 1: List Apps
+        console.log('--- Test 1: listApps() ---');
+        const apps = await client.listApps();
+        console.log(`✅ Found ${apps.length} apps:`);
+        for (const app of apps.slice(0, 5)) { // Show first 5
+            const fqdn = app.location ? `${app.location}.${app.domain}` : app.domain;
+            console.log(`   - ${app.manifest.title} (${fqdn})`);
+            console.log(`     State: ${app.installationState}, Health: ${app.health}`);
+        }
+        if (apps.length > 5) {
+            console.log(`   ... and ${apps.length - 5} more\n`);
+        }
+        else {
+            console.log('');
+        }
+        // Test 2: Get Single App (if we have any apps)
+        if (apps.length > 0) {
+            const firstApp = apps[0];
+            if (!firstApp) {
+                throw new Error('First app is undefined');
+            }
+            console.log(`--- Test 2: getApp('${firstApp.id}') ---`);
+            const app = await client.getApp(firstApp.id);
+            console.log(`✅ Retrieved app: ${app.manifest.title}`);
+            console.log(`   ID: ${app.id}`);
+            console.log(`   FQDN: ${app.fqdn}`);
+            console.log(`   Memory: ${app.memoryLimit} bytes`);
+            console.log(`   Created: ${app.creationTime}\n`);
+        }
+        // Test 3: Error handling - invalid app ID
+        console.log('--- Test 3: Error Handling (invalid app ID) ---');
+        try {
+            await client.getApp('non-existent-app-id-12345');
+            console.log('❌ Expected error but got success');
+        }
+        catch (error) {
+            if (isCloudronError(error)) {
+                console.log(`✅ Caught CloudronError as expected`);
+                console.log(`   Message: ${error.message}`);
+                console.log(`   Status: ${error.statusCode}`);
+                console.log(`   Retryable: ${error.isRetryable()}\n`);
+            }
+            else {
+                throw error;
+            }
+        }
+        console.log('=== All Tests Passed! ===');
+    }
+    catch (error) {
+        console.error('\n❌ Test Failed:');
+        if (isCloudronError(error)) {
+            console.error(`   CloudronError: ${error.message}`);
+            console.error(`   Status: ${error.statusCode}`);
+            console.error(`   Code: ${error.code}`);
+        }
+        else if (error instanceof Error) {
+            console.error(`   Error: ${error.message}`);
+        }
+        else {
+            console.error('   Unknown error:', error);
+        }
+        process.exit(1);
+    }
+}
+runTests();
+//# sourceMappingURL=test.js.map

package/dist/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../src/test.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Cloudron API TypeScript Definitions
+ * MVP scope: listApps + getApp endpoints
+ */
+/**
+ * Configuration for CloudronClient - enables DI for testing
+ */
+export interface CloudronClientConfig {
+    baseUrl: string;
+    token: string;
+}
+/**
+ * App manifest subset containing metadata
+ */
+export interface AppManifest {
+    id: string;
+    version: string;
+    title: string;
+    description: string;
+    tagline?: string;
+    website?: string;
+    author?: string;
+}
+/**
+ * Cloudron App representation
+ */
+export interface App {
+    id: string;
+    appStoreId: string;
+    installationState: 'pending_install' | 'installed' | 'pending_configure' | 'pending_uninstall' | 'pending_restore' | 'error';
+    installationProgress: string;
+    runState: 'running' | 'stopped' | 'dead';
+    health: 'healthy' | 'unhealthy' | 'unknown';
+    location: string;
+    domain: string;
+    fqdn: string;
+    accessRestriction: string | null;
+    manifest: AppManifest;
+    portBindings: Record<string, number> | null;
+    iconUrl: string | null;
+    memoryLimit: number;
+    creationTime: string;
+}
+/**
+ * API response wrapper for listing apps
+ */
+export interface AppsResponse {
+    apps: App[];
+}
+/**
+ * API response wrapper for single app
+ */
+export interface AppResponse {
+    app: App;
+}
+/**
+ * System status response from /api/v1/cloudron/status
+ */
+export interface SystemStatus {
+    version: string;
+    apiServerOrigin: string;
+    adminFqdn: string;
+    provider: string;
+    cloudronName: string;
+    isDemo: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,iBAAiB,GAAG,WAAW,GAAG,mBAAmB,GAAG,mBAAmB,GAAG,iBAAiB,GAAG,OAAO,CAAC;IAC7H,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACzC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,WAAW,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC5C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,GAAG,EAAE,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,GAAG,CAAC;CACV;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB"}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Cloudron API TypeScript Definitions
+ * MVP scope: listApps + getApp endpoints
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@serenichron/mcp-cloudron",
+  "version": "0.1.0",
+  "description": "MCP server for Cloudron instance management - list apps, get status, and manage your self-hosted applications",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "mcp-cloudron": "dist/server.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "dev": "tsx watch src/index.ts",
+    "test": "tsx src/test.ts",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "cloudron",
+    "model-context-protocol",
+    "ai",
+    "automation",
+    "self-hosted",
+    "server-management",
+    "claude",
+    "anthropic"
+  ],
+  "author": "Serenichron <vlad@serenichron.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/serenichron/mcp-cloudron.git"
+  },
+  "bugs": {
+    "url": "https://github.com/serenichron/mcp-cloudron/issues"
+  },
+  "homepage": "https://github.com/serenichron/mcp-cloudron#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.24.3"
+  }
+}