Cloudeval

Servidor MCP para revisão de arquitetura de nuvem antes da implantação. Permite que agentes de IA como Codex, Cursor, Claude Code e VS Code avaliem modelos Azure ARM, Bicep (compilado para ARM), ambientes Azure ao vivo e AWS CloudFormation (beta), gerem diagramas de arquitetura e retornem descobertas de custo, segurança e Well-Architected com base em evidências, a partir de mais de 1.650 verificações. Nome no registro MCP: io.github.ganakailabs/cloudeval.

GitHubExperimente este MCPPatrocinado

Documentação

Documentação do Cloudeval

Documentação do Cloudeval construída com MkDocs e tema Material.

Configuração

  1. Instale as dependências:

    pip install -r requirements.txt

  2. Sirva a documentação localmente:

    mkdocs serve

    Visite http://127.0.0.1:8000 para visualizar o site.

  3. Compile a documentação:

    mkdocs build

Estrutura

  • docs/ - Arquivos-fonte da documentação
  • mkdocs.yml - Configuração do MkDocs
  • requirements.txt - Dependências Python
  • .github/workflows/docs.yaml - Fluxo de trabalho do GitHub Actions para implantação

Implantação

A documentação é implantada automaticamente no GitHub Pages usando GitHub Actions:

  1. Implantação Automática: A cada push para o branch main
  2. Implantação Manual: Use o dispatch de fluxo de trabalho no GitHub Actions
  3. Processo de Implantação:
    • Compila o site MkDocs
    • Envia para o branch gh-pages
    • Implanta via GitHub Pages Actions

Configuração Inicial

Antes da primeira implantação:

  1. Habilite o GitHub Pages nas Configurações do repositório → Pages (Fonte: GitHub Actions)
  2. Crie o branch gh-pages (veja DEPLOYMENT.md)
  3. Envie o arquivo de fluxo de trabalho para acionar a implantação

URL do Site

Após a implantação, o site estará disponível em:

  • Domínio personalizado: https://docs.cloudeval.ai/ (após configuração de DNS)
  • GitHub Pages: https://ganakailabs.github.io/cloudeval/

Domínio Personalizado

Este repositório está configurado para usar o domínio personalizado docs.cloudeval.ai.

Para configuração de DNS no Namecheap, veja NAMECHEAP_DNS_SETUP.md para instruções passo a passo.

Para informações gerais sobre domínio personalizado, veja docs/CUSTOM_DOMAIN.md.

Documentação