AEGIS Governance

AEGIS Governance — Servidor MCP

Status: o serviço AEGIS hospedado está offline (desde setembro de 2026). A API hospedada e o endpoint MCP hospedado (mcp.aegis.undercurrentholdings.com) estão offline. O servidor local não avalia propostas por conta própria, portanto nenhuma ferramenta retorna uma avaliação neste momento. Status atual: https://undercurrentholdings.com/status/

O que o pacote é

aegis-governance no PyPI é um cliente Python para a API AEGIS. Ele também contém um servidor MCP local. O pacote instala um script de console, aegis-mcp-server. Este script inicia um servidor MCP local que usa o transporte stdio. O pacote não possui nenhuma outra ferramenta de linha de comando.

O servidor local não possui mecanismo de avaliação. Por padrão, o cliente envia todas as solicitações para a API AEGIS hospedada. O modo sandbox (o modo sem chave de API) também usa a API hospedada. Enquanto o serviço hospedado estiver offline, as chamadas de ferramenta não retornam avaliações.

Instalação

pip install "aegis-governance[mcp]"

O extra [mcp] é necessário para aegis-mcp-server. Em Python < 3.10, o extra não instala nada, e aegis-mcp-server sai com uma dica de instalação.

Configuração local do MCP stdio

Claude Code

claude mcp add aegis -- aegis-mcp-server

Cursor (.cursor/mcp.json) / Windsurf / qualquer cliente MCP stdio:

{
  "mcpServers": {
    "aegis": { "command": "aegis-mcp-server" }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "aegis": { "type": "stdio", "command": "aegis-mcp-server" }
  }
}

Ferramentas

tools/list de aegis-mcp-server em aegis-governance 1.4.2 retorna estas seis ferramentas. Sem AEGIS_API_KEY, aegis_evaluate_proposal e aegis_health chamam a API hospedada, e as outras quatro ferramentas retornam um resultado JSON AuthenticationError sem uma chamada de API. Com AEGIS_API_KEY definido, todas as seis ferramentas chamam a API hospedada.

As descrições abaixo são citadas do servidor. Elas não descrevem um serviço que esteja disponível agora.

Ferramenta	Descrição (citada do servidor)
aegis_evaluate_proposal	Avaliar uma proposta de engenharia por meio das verificações de portão da AEGIS.
aegis_quick_risk_check	Verificação rápida de limite de risco sem uma avaliação bayesiana completa.
aegis_health	Verificar a saúde da API AEGIS (status do serviço, versão, componentes).
aegis_list_decisions	Listar decisões de governança recentes para o cliente autenticado.
aegis_get_decision	Buscar uma decisão de governança específica por ID, com detalhes completos do portão.
aegis_get_usage	Obter o relatório de uso de avaliação do cliente autenticado.

Lendo o código-fonte

O repositório de código-fonte aegis-governance é privado. Para ler o código-fonte publicado, baixe a distribuição de código-fonte (sdist) do PyPI:

pip download --no-binary :all: --no-deps "aegis-governance==1.4.2"

Ou obtenha o arquivo .tar.gz dos arquivos de release do PyPI.