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

Tool	Recursos
block_storage	volumes, snapshots, volume-types, schedulers
virtual_machine	instances, images, machine-types, snapshots
kubernetes	cluster, nodepool, flavor, version
dbaas	instances, clusters, replicas, snapshots, engines, instance-types, parameter-groups
network	vpcs, security-groups, public-ips, ports, subnetpools, subnets¹, rules¹
container_registry	registries, repositories, images, proxy-caches
audit	events, event-types

¹ 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

Parâmetro	Tipo	Descrição
resource	string	Recurso a consultar (ver tabela acima)
action	list | get	Operação
id	string	ID do recurso (obrigatório para get)
region	string	br-ne1 ou br-se1 — sobrescreve MGC_REGION
parent_id	string	ID do recurso pai (apenas network com subnets/rules)

Inferência de região

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

Menção	Região
"nordeste", "ne", "NE1"	br-ne1
"sudeste", "se", "SE1"	br-se1

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