Liara MCP Server

Instructions

Implementation Reference

• src/services/storage.ts:62-68 (handler)

  The core handler function that implements the tool logic by validating the bucket name and fetching S3-compatible credentials from the Liara API.

  export async function getBucketCredentials(
      client: LiaraClient,
      name: string
  ): Promise<BucketCredentials> {
      validateRequired(name, 'Bucket name');
      return await client.get<BucketCredentials>(`/v1/buckets/${name}/credentials`);
  }

• src/api/types.ts:181-186 (schema)

  TypeScript interface defining the structure of the credentials object returned by the tool.

  export interface BucketCredentials {
      accessKey: string;
      secretKey: string;
      endpoint: string;
      bucket: string;
  }

• src/api/types.ts:174-179 (schema)

  TypeScript interface for Bucket details, used in related storage operations.

  export interface Bucket {
      _id: string;
      name: string;
      region: string;
      createdAt: string;
  }

• src/utils/errors.ts:54-58 (helper)

  Validation helper used in the handler to ensure bucket name is provided.

  export function validateRequired(value: any, fieldName: string): void {
      if (value === undefined || value === null || value === '') {
          throw new LiaraMcpError(`${fieldName} is required`);
      }
  }

• src/utils/errors.ts:134-154 (helper)

  Helper to unwrap API responses, though not directly used in this handler.

  export function unwrapApiResponse<T>(response: any, expectedArrayKeys?: string[]): T {
      if (!response) return response;
      
      // If it's already the expected type (array or primitive), return as-is
      if (Array.isArray(response)) {
          return response as T;
      }
      
      // Common wrapper keys that APIs use
      const arrayKeys = expectedArrayKeys || ['data', 'items', 'results', 'projects', 'databases', 'buckets', 'zones', 'records', 'backups', 'releases', 'domains', 'vms', 'plans'];
      
      // Try to unwrap from common wrapper keys
      for (const key of arrayKeys) {
          if (response[key] !== undefined) {
              return response[key] as T;
          }
      }
      
      // Return as-is if no wrapper found
      return response as T;
  }