feat(mgc): add Magalu Cloud CLI MCP server

Wraps the mgc CLI with 27 tools covering VMs, object storage, network,
Kubernetes, DBaaS, and block storage. Includes a generic mgc_execute
tool for any command not covered by specific tools.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: Jott4

packages/mgc/.gitignore

@@ -0,0 +1,4 @@
+node_modules/
+dist/
+*.js.map
+.env

packages/mgc/README.md

@@ -0,0 +1,76 @@
+# @arvoretech/mgc-mcp
+
+MCP Server for [Magalu Cloud CLI (mgc)](https://github.com/MagaluCloud/mgccli) — manage cloud infrastructure through AI assistants.
+
+## Prerequisites
+
+- [MGC CLI](https://github.com/MagaluCloud/mgccli) installed and authenticated (`mgc auth login`)
+- Node.js >= 20
+
+## Configuration
+
+Add to your MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "mgc": {
+      "command": "npx",
+      "args": ["@arvoretech/mgc-mcp"]
+    }
+  }
+}
+```
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `MGC_CLI_PATH` | Custom path to the mgc binary | `mgc` |
+
+## Available Tools
+
+### General
+- **mgc_execute** — Run any mgc CLI command
+- **mgc_auth_status** — Check authentication status
+
+### Virtual Machines
+- **mgc_vm_list** — List VM instances
+- **mgc_vm_create** — Create a VM
+- **mgc_vm_get** — Get VM details
+- **mgc_vm_delete** — Delete a VM
+- **mgc_vm_start/stop/reboot** — VM lifecycle actions
+- **mgc_vm_machine_types_list** — List available machine types
+- **mgc_vm_images_list** — List available OS images
+
+### Object Storage
+- **mgc_object_storage_list_buckets** — List buckets
+- **mgc_object_storage_create_bucket** — Create a bucket
+- **mgc_object_storage_delete_bucket** — Delete a bucket
+- **mgc_object_storage_list_objects** — List objects in a bucket
+- **mgc_object_storage_upload** — Upload a file
+
+### Network
+- **mgc_network_vpc_list** — List VPCs
+- **mgc_network_vpc_create** — Create a VPC
+- **mgc_network_subnets_list** — List subnets
+- **mgc_network_public_ip_list** — List public IPs
+
+### Kubernetes
+- **mgc_kubernetes_cluster_list** — List clusters
+- **mgc_kubernetes_cluster_create** — Create a cluster
+- **mgc_kubernetes_get_kubeconfig** — Get kubeconfig
+
+### Database (DBaaS)
+- **mgc_dbaas_instance_list** — List database instances
+
+### Block Storage
+- **mgc_block_storage_volume_list** — List volumes
+- **mgc_block_storage_volume_create** — Create a volume
+
+## Development
+
+```bash
+pnpm install
+pnpm -F @arvoretech/mgc-mcp dev
+```

packages/mgc/eslint.config.js

@@ -0,0 +1,42 @@
+import js from "@eslint/js";
+import tseslint from "@typescript-eslint/eslint-plugin";
+import tsparser from "@typescript-eslint/parser";
+
+export default [
+  js.configs.recommended,
+  {
+    files: ["src/**/*.ts"],
+    languageOptions: {
+      parser: tsparser,
+      parserOptions: {
+        ecmaVersion: 2022,
+        sourceType: "module",
+      },
+      globals: {
+        console: "readonly",
+        process: "readonly",
+        fetch: "readonly",
+        Buffer: "readonly",
+        __dirname: "readonly",
+        __filename: "readonly",
+        global: "readonly",
+        setTimeout: "readonly",
+      },
+    },
+    plugins: {
+      "@typescript-eslint": tseslint,
+    },
+    rules: {
+      ...tseslint.configs.recommended.rules,
+      "@typescript-eslint/no-unused-vars": [
+        "error",
+        { argsIgnorePattern: "^_" },
+      ],
+      "@typescript-eslint/no-explicit-any": "warn",
+      "@typescript-eslint/explicit-function-return-type": "off",
+      "@typescript-eslint/explicit-module-boundary-types": "off",
+      "no-console": "off",
+      "no-undef": "error",
+    },
+  },
+];

packages/mgc/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@arvoretech/mgc-mcp",
+  "version": "1.0.0",
+  "description": "Magalu Cloud (MGC) CLI MCP Server for managing cloud infrastructure",
+  "main": "dist/index.js",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "mgc-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:cov": "vitest run --coverage",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix"
+  },
+  "keywords": [
+    "mcp",
+    "mgc",
+    "magalu",
+    "cloud",
+    "cli",
+    "infrastructure",
+    "llm",
+    "ai",
+    "arvore"
+  ],
+  "author": "Arvore",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/arvoreeducacao/arvore-mcp-servers.git",
+    "directory": "packages/mgc"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.22.4"
+  }
+}

packages/mgc/src/index.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+
+import { MgcMCPServer } from "./server.js";
+
+try {
+  const server = new MgcMCPServer();
+  server.setupGracefulShutdown();
+  await server.start();
+} catch (error) {
+  console.error("Failed to start MGC MCP Server:", error);
+  process.exit(1);
+}
+
+export { MgcMCPServer } from "./server.js";
+export { MgcClient } from "./mgc-client.js";
+export { MgcTools } from "./tools.js";
+export * from "./types.js";

packages/mgc/src/mgc-client.ts

@@ -0,0 +1,77 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+
+const execFileAsync = promisify(execFile);
+
+export interface MgcExecResult {
+  stdout: string;
+  stderr: string;
+  exitCode: number;
+}
+
+export class MgcClient {
+  private mgcPath: string;
+
+  constructor(mgcPath?: string) {
+    this.mgcPath = mgcPath || process.env.MGC_CLI_PATH || "mgc";
+  }
+
+  async execute(
+    args: string[],
+    options?: { timeout?: number }
+  ): Promise<MgcExecResult> {
+    const timeout = options?.timeout || 60000;
+
+    try {
+      const { stdout, stderr } = await execFileAsync(this.mgcPath, args, {
+        timeout,
+        maxBuffer: 10 * 1024 * 1024,
+        env: {
+          ...process.env,
+          NO_COLOR: "1",
+        },
+      });
+
+      return { stdout, stderr, exitCode: 0 };
+    } catch (error: unknown) {
+      const execError = error as {
+        stdout?: string;
+        stderr?: string;
+        code?: number | string;
+        killed?: boolean;
+      };
+
+      if (execError.killed) {
+        return {
+          stdout: execError.stdout || "",
+          stderr: `Command timed out after ${timeout}ms`,
+          exitCode: 124,
+        };
+      }
+
+      return {
+        stdout: execError.stdout || "",
+        stderr: execError.stderr || String(error),
+        exitCode: typeof execError.code === "number" ? execError.code : 1,
+      };
+    }
+  }
+
+  async executeCommand(
+    command: string,
+    outputFormat?: string
+  ): Promise<MgcExecResult> {
+    const args = command.split(/\s+/).filter(Boolean);
+
+    if (outputFormat && !args.includes("-o") && !args.includes("--output")) {
+      args.push("-o", outputFormat);
+    }
+
+    // Always add --no-confirm to avoid interactive prompts
+    if (!args.includes("--no-confirm")) {
+      args.push("--no-confirm");
+    }
+
+    return this.execute(args);
+  }
+}