LocalStack MCP Server

import { PassThrough } from "stream"; export interface ContainerExecResult { stdout: string; stderr: string; exitCode: number; } export class DockerApiClient { private docker: any; constructor() { const DockerCtor = (eval("require") as any)("dockerode"); this.docker = new DockerCtor(); } async findLocalStackContainer(): Promise<string> { const running = (await (this.docker.listContainers as any)({ filters: { status: ["running"] }, })) as Array<{ Id: string; Names?: string[] }>; const match = (running || []).find((c) => (c.Names || []).some((n) => { const name = (n || "").startsWith("/") ? n.slice(1) : n; return name === "localstack-main"; }) ); if (match) return match.Id as string; throw new Error("Could not find a running LocalStack container named 'localstack-main'."); } async executeInContainer( containerId: string, command: string[], stdin?: string ): Promise<ContainerExecResult> { const container = this.docker.getContainer(containerId); const exec = await container.exec({ Cmd: command, AttachStdout: true, AttachStderr: true, ...(stdin ? { AttachStdin: true } : {}), }); const stream: NodeJS.ReadWriteStream = await new Promise((resolve, reject) => { exec.start({ hijack: true, stdin: Boolean(stdin) } as any, (err: any, stream: any) => { if (err) return reject(err); resolve(stream as NodeJS.ReadWriteStream); }); }); if (stdin) { stream.write(stdin); stream.end(); } const stdoutStream = new PassThrough(); const stderrStream = new PassThrough(); const stdoutChunks: Buffer[] = []; const stderrChunks: Buffer[] = []; stdoutStream.on("data", (d) => stdoutChunks.push(Buffer.isBuffer(d) ? d : Buffer.from(d))); stderrStream.on("data", (d) => stderrChunks.push(Buffer.isBuffer(d) ? d : Buffer.from(d))); await new Promise<void>((resolve, reject) => { // demux combined docker stream into stdout/stderr (this.docker as any).modem.demuxStream(stream as any, stdoutStream, stderrStream); stream.on("end", () => resolve()); stream.on("error", (e) => reject(e)); }); const inspect = (await exec.inspect()) as { ExitCode: number | null }; const exitCode = inspect && inspect.ExitCode !== null ? inspect.ExitCode : 1; const stdout = Buffer.concat(stdoutChunks).toString("utf8").trim(); const stderr = Buffer.concat(stderrChunks).toString("utf8").trim(); return { stdout, stderr, exitCode }; } }