Homelab MCP Server

// Host configuration for multi-host homelab setup export interface HostConfig { name: string; host: string; port?: number; protocol: "http" | "https" | "ssh"; // For SSH connections (to Docker socket) sshUser?: string; sshKeyPath?: string; // For direct Docker API dockerSocketPath?: string; // Tags for filtering tags?: string[]; } // Container info returned from Docker API export interface ContainerInfo { id: string; name: string; image: string; state: "running" | "paused" | "exited" | "created" | "restarting" | "removing" | "dead"; status: string; created: string; ports: PortBinding[]; labels: Record<string, string>; hostName: string; } export interface PortBinding { containerPort: number; hostPort?: number; protocol: "tcp" | "udp"; hostIp?: string; } // Container stats for monitoring export interface ContainerStats { containerId: string; containerName: string; cpuPercent: number; memoryUsage: number; memoryLimit: number; memoryPercent: number; networkRx: number; networkTx: number; blockRead: number; blockWrite: number; } // Log entry with metadata export interface LogEntry { timestamp: string; stream: "stdout" | "stderr"; message: string; } // Service health aggregation export interface ServiceHealth { name: string; host: string; containerId: string; state: string; uptime: string; restartCount: number; healthStatus?: "healthy" | "unhealthy" | "starting" | "none"; lastHealthCheck?: string; } // Response format enum export enum ResponseFormat { JSON = "json", MARKDOWN = "markdown" } // Pagination metadata export interface PaginationMeta { total: number; count: number; offset: number; hasMore: boolean; nextOffset?: number; } // Generic paginated response export interface PaginatedResponse<T> { items: T[]; pagination: PaginationMeta; } // Host status for overview export interface HostStatus { name: string; host: string; connected: boolean; containerCount: number; runningCount: number; error?: string; } // Compose project info export interface ComposeProject { name: string; host: string; services: string[]; status: "running" | "partial" | "stopped"; configPath?: string; }