@arvoretech/mgc-mcp

MCP Server for Magalu Cloud CLI (mgc) — manage cloud infrastructure through AI assistants.

Prerequisites

• MGC CLI installed and authenticated (mgc auth login)
• Node.js >= 20

Configuration

Add to your MCP client config:

{
  "mcpServers": {
    "mgc": {
      "command": "npx",
      "args": ["@arvoretech/mgc-mcp"]
    }
  }
}

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | MGC_CLI_PATH | Custom path to the mgc binary | mgc | | MGC_REGION | Default region for all commands (e.g., br-ne1, br-se1, br-mgl1) | CLI default | | MAGALU_DOCS_DIR | Path to scraped Magalu docs (enables doc search tools) | — |

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

Documentation Search

• search_magalu_docs — Semantic search across Magalu developer docs (requires MAGALU_DOCS_DIR)
• get_magalu_doc — Get full markdown content of a doc page (use search first to find filepath)

Scraping docs

Use docusaurus-to-md to scrape the Magalu docs into a local directory:

npx @arvoretech/docusaurus-to-md https://dev.magalu.com -o ./docs-cache

Then set MAGALU_DOCS_DIR to the output path when running the MCP server.

Development

pnpm install
pnpm -F @arvoretech/mgc-mcp dev