mcp-mgccli

MCP server for read-only queries on Magalu Cloud via mgc CLI.

Exposes 7 MCP tools (one per product), covering list and get operations. All authentication is handled via API key — no credentials in the code.

Requirements

• Python 3.11+

• mgc CLI v0.54.0+ in PATH

• Magalu Cloud API key with read permissions

Related MCP server: cloud-chat-assistant

Installation

pip install -e /caminho/para/mcp-mgccli

Configuration

Copy the example file and fill in your API key:

cp .env.example .env

.env:

MGC_API_KEY=sua-api-key-aqui
MGC_REGION=br-ne1   # opcional — br-ne1 ou br-se1
MGC_TIMEOUT=30      # opcional — timeout em segundos (default: 30)

Integration with Claude Code

The server is started automatically via start-mcp.sh, which loads the .env. To register:

claude mcp add --scope user mgc /caminho/para/mcp-mgccli/start-mcp.sh

Or add it manually to ~/.claude.json:

{
  "mcpServers": {
    "mgc": {
      "command": "/caminho/para/mcp-mgccli/start-mcp.sh"
    }
  }
}

Integration with Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "mgc": {
      "command": "/caminho/para/mcp-mgccli/start-mcp.sh"
    }
  }
}

Available Tools

¹ subnets and rules are sub-resources — they require parent_id for list:

• subnets list: parent_id=<vpc-id>

• rules list: parent_id=<security-group-id>

Common Parameters

Region Inference

Claude infers the region automatically from natural language:

If the region is not mentioned and MGC_REGION is not set, Claude will ask before executing.

Usage Examples

"Liste minhas VMs no nordeste"
"Quais volumes existem no sudeste?"
"Mostre detalhes do cluster Kubernetes abc-123"
"Liste os security groups da região br-ne1"
"Quais subnets existem na VPC 7211a812-f159-4757-a6ba-c09933a5f6d8?"
"Liste as regras do security group bf8743af-f14b-4f31-917e-8e8160cff838"

Development

# instalar em modo editável
pip install -e .

# rodar testes
python -m pytest tests/ -v