mcp-mgccli

MCP server para consultas de leitura na Magalu Cloud via mgc CLI.

Expõe 7 tools MCP (um por produto), cobrindo operações list e get. Toda autenticação é feita via API key — nenhuma credencial no código.

Requisitos

• Python 3.11+

• mgc CLI v0.54.0+ no PATH

• API key Magalu Cloud com permissões de leitura

Instalação

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

Configuração

Copie o arquivo de exemplo e preencha sua 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)

Integração com Claude Code

O servidor já é iniciado automaticamente via start-mcp.sh, que carrega o .env. Para registrar:

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

Ou adicione manualmente em ~/.claude.json:

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

Integração com Claude Desktop

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

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

Tools Disponíveis

¹ subnets e rules são subrecursos — exigem parent_id para list:

• subnets list: parent_id=<vpc-id>

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

Parâmetros comuns

Inferência de região

O Claude infere a região automaticamente a partir de linguagem natural:

Se a região não for mencionada e MGC_REGION não estiver definido, o Claude pergunta antes de executar.

Exemplos de uso

"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"

Desenvolvimento

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

# rodar testes
python -m pytest tests/ -v