liara-mcp 0.1.0

package/dist/services/storage.js

@@ -0,0 +1,96 @@
+import { paginationToParams, } from '../api/types.js';
+import { validateRequired } from '../utils/errors.js';
+import { createReadStream } from 'fs';
+import FormData from 'form-data';
+/**
+ * List all buckets
+ */
+export async function listBuckets(client, pagination) {
+    const params = paginationToParams(pagination);
+    return await client.get('/v1/buckets', params);
+}
+/**
+ * Get details of a specific bucket
+ */
+export async function getBucket(client, name) {
+    validateRequired(name, 'Bucket name');
+    return await client.get(`/v1/buckets/${name}`);
+}
+/**
+ * Create a new bucket
+ */
+export async function createBucket(client, request) {
+    validateRequired(request.name, 'Bucket name');
+    return await client.post('/v1/buckets', request);
+}
+/**
+ * Delete a bucket
+ */
+export async function deleteBucket(client, name) {
+    validateRequired(name, 'Bucket name');
+    await client.delete(`/v1/buckets/${name}`);
+}
+/**
+ * Get bucket credentials (S3-compatible access keys)
+ */
+export async function getBucketCredentials(client, name) {
+    validateRequired(name, 'Bucket name');
+    return await client.get(`/v1/buckets/${name}/credentials`);
+}
+/**
+ * List objects in a bucket
+ */
+export async function listObjects(client, bucketName, prefix, maxKeys) {
+    validateRequired(bucketName, 'Bucket name');
+    const params = {};
+    if (prefix)
+        params.prefix = prefix;
+    if (maxKeys)
+        params.maxKeys = maxKeys;
+    return await client.get(`/v1/buckets/${bucketName}/objects`, params);
+}
+/**
+ * Upload an object to a bucket
+ */
+export async function uploadObject(client, bucketName, objectKey, filePath) {
+    validateRequired(bucketName, 'Bucket name');
+    validateRequired(objectKey, 'Object key');
+    validateRequired(filePath, 'File path');
+    // Note: This would typically use multipart/form-data or direct file upload
+    // For now, we'll use a generic POST endpoint
+    const formData = new FormData();
+    const fileName = filePath.split('/').pop() || objectKey;
+    formData.append('file', createReadStream(filePath), {
+        filename: fileName,
+    });
+    formData.append('key', objectKey);
+    return await client.postFormData(`/v1/buckets/${bucketName}/objects`, formData);
+}
+/**
+ * Get download URL for an object
+ */
+export async function getObjectDownloadUrl(client, bucketName, objectKey, expiresIn) {
+    validateRequired(bucketName, 'Bucket name');
+    validateRequired(objectKey, 'Object key');
+    const params = {};
+    if (expiresIn)
+        params.expiresIn = expiresIn;
+    return await client.get(`/v1/buckets/${bucketName}/objects/${encodeURIComponent(objectKey)}/download`, params);
+}
+/**
+ * Delete an object from a bucket
+ */
+export async function deleteObject(client, bucketName, objectKey) {
+    validateRequired(bucketName, 'Bucket name');
+    validateRequired(objectKey, 'Object key');
+    await client.delete(`/v1/buckets/${bucketName}/objects/${encodeURIComponent(objectKey)}`);
+}
+/**
+ * Get object metadata
+ */
+export async function getObjectMetadata(client, bucketName, objectKey) {
+    validateRequired(bucketName, 'Bucket name');
+    validateRequired(objectKey, 'Object key');
+    return await client.get(`/v1/buckets/${bucketName}/objects/${encodeURIComponent(objectKey)}/metadata`);
+}
+//# sourceMappingURL=storage.js.map

package/dist/services/storage.js.map

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

package/dist/services/user.d.ts

@@ -0,0 +1,32 @@
+import { LiaraClient } from '../api/client.js';
+/**
+ * User information response
+ */
+export interface UserInfo {
+    _id: string;
+    email: string;
+    username?: string;
+    firstName?: string;
+    lastName?: string;
+    phone?: string;
+    plans?: {
+        app?: any[];
+        database?: any[];
+        vm?: any[];
+    };
+    teams?: Array<{
+        _id: string;
+        name: string;
+    }>;
+    createdAt: string;
+}
+/**
+ * Get comprehensive user information
+ * This endpoint returns user account details, available plans, and database versions
+ */
+export declare function getUserInfo(client: LiaraClient): Promise<UserInfo>;
+/**
+ * List user accounts (for multi-account support)
+ */
+export declare function listAccounts(client: LiaraClient): Promise<UserInfo[]>;
+//# sourceMappingURL=user.d.ts.map

package/dist/services/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/services/user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE;QACJ,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC;QACZ,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;QACjB,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;KACd,CAAC;IACF,KAAK,CAAC,EAAE,KAAK,CAAC;QACV,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAExE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAI3E"}

package/dist/services/user.js

@@ -0,0 +1,16 @@
+/**
+ * Get comprehensive user information
+ * This endpoint returns user account details, available plans, and database versions
+ */
+export async function getUserInfo(client) {
+    return await client.get('/v1/me');
+}
+/**
+ * List user accounts (for multi-account support)
+ */
+export async function listAccounts(client) {
+    // This might be a different endpoint, but for now we return the current user
+    const userInfo = await getUserInfo(client);
+    return [userInfo];
+}
+//# sourceMappingURL=user.js.map

package/dist/services/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../src/services/user.ts"],"names":[],"mappings":"AAwBA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAmB;IACjD,OAAO,MAAM,MAAM,CAAC,GAAG,CAAW,QAAQ,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAmB;IAClD,6EAA6E;IAC7E,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3C,OAAO,CAAC,QAAQ,CAAC,CAAC;AACtB,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Custom error class for Liara MCP operations
+ */
+export declare class LiaraMcpError extends Error {
+    code?: string | undefined;
+    details?: any | undefined;
+    constructor(message: string, code?: string | undefined, details?: any | undefined);
+}
+/**
+ * Format error for MCP response
+ */
+export declare function formatErrorForMcp(error: unknown): string;
+/**
+ * Validate that a value is not empty
+ */
+export declare function validateRequired(value: any, fieldName: string): void;
+/**
+ * Validate app name format
+ * Must be lowercase alphanumeric with hyphens, 3-32 characters
+ */
+export declare function validateAppName(name: string): void;
+/**
+ * Validate domain name format
+ */
+export declare function validateDomainName(domain: string): void;
+/**
+ * Validate environment variable key
+ */
+export declare function validateEnvKey(key: string): void;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IAGzB,IAAI,CAAC,EAAE,MAAM;IACb,OAAO,CAAC,EAAE,GAAG;gBAFpB,OAAO,EAAE,MAAM,EACR,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,OAAO,CAAC,EAAE,GAAG,YAAA;CAK3B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKxD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAIpE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAYlD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAOvD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAQhD"}

package/dist/utils/errors.js

@@ -0,0 +1,63 @@
+/**
+ * Custom error class for Liara MCP operations
+ */
+export class LiaraMcpError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'LiaraMcpError';
+    }
+}
+/**
+ * Format error for MCP response
+ */
+export function formatErrorForMcp(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+/**
+ * Validate that a value is not empty
+ */
+export function validateRequired(value, fieldName) {
+    if (value === undefined || value === null || value === '') {
+        throw new LiaraMcpError(`${fieldName} is required`);
+    }
+}
+/**
+ * Validate app name format
+ * Must be lowercase alphanumeric with hyphens, 3-32 characters
+ */
+export function validateAppName(name) {
+    validateRequired(name, 'App name');
+    if (!/^[a-z0-9-]{3,32}$/.test(name)) {
+        throw new LiaraMcpError('App name must be 3-32 characters long and contain only lowercase letters, numbers, and hyphens');
+    }
+    if (name.startsWith('-') || name.endsWith('-')) {
+        throw new LiaraMcpError('App name cannot start or end with a hyphen');
+    }
+}
+/**
+ * Validate domain name format
+ */
+export function validateDomainName(domain) {
+    validateRequired(domain, 'Domain name');
+    const domainRegex = /^([a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,}$/i;
+    if (!domainRegex.test(domain)) {
+        throw new LiaraMcpError('Invalid domain name format');
+    }
+}
+/**
+ * Validate environment variable key
+ */
+export function validateEnvKey(key) {
+    validateRequired(key, 'Environment variable key');
+    if (!/^[A-Z_][A-Z0-9_]*$/.test(key)) {
+        throw new LiaraMcpError('Environment variable key must start with a letter or underscore and contain only uppercase letters, numbers, and underscores');
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAGzB;IACA;IAHX,YACI,OAAe,EACR,IAAa,EACb,OAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAAS;QACb,YAAO,GAAP,OAAO,CAAM;QAGpB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAChC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,OAAO,CAAC;IACzB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAU,EAAE,SAAiB;IAC1D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACxD,MAAM,IAAI,aAAa,CAAC,GAAG,SAAS,cAAc,CAAC,CAAC;IACxD,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IACxC,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAEnC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,aAAa,CACnB,gGAAgG,CACnG,CAAC;IACN,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,aAAa,CAAC,4CAA4C,CAAC,CAAC;IAC1E,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC7C,gBAAgB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAExC,MAAM,WAAW,GAAG,yCAAyC,CAAC;IAC9D,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,aAAa,CAAC,4BAA4B,CAAC,CAAC;IAC1D,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACtC,gBAAgB,CAAC,GAAG,EAAE,0BAA0B,CAAC,CAAC;IAElD,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,aAAa,CACnB,8HAA8H,CACjI,CAAC;IACN,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "liara-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Liara cloud platform - deploy and manage apps, databases, and infrastructure",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "liara-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "liara",
+    "cloud",
+    "deployment",
+    "paas",
+    "dbaas",
+    "iaas",
+    "iran",
+    "persian",
+    "farsi"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/YOUR_USERNAME/liara-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/YOUR_USERNAME/liara-mcp/issues"
+  },
+  "homepage": "https://github.com/YOUR_USERNAME/liara-mcp#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.5.0",
+    "@types/form-data": "^2.2.1",
+    "axios": "^1.6.0",
+    "form-data": "^4.0.5",
+    "ws": "^8.16.0",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/ws": "^8.5.10",
+    "@vitest/coverage-v8": "^1.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}