AEGIS Governance

Gobernanza de seis compuertas para agentes de IA: decisiones de PROCEDER/PAUSAR/DETENER con registros de auditoría encadenados por hash.

Documentación

AEGIS Governance — Servidor MCP

Estado: el servicio AEGIS alojado está fuera de línea (desde septiembre de 2026). La API alojada y el endpoint MCP alojado (mcp.aegis.undercurrentholdings.com) están fuera de línea. El servidor local no evalúa propuestas por sí mismo, por lo que ninguna herramienta devuelve una evaluación en este momento. Estado actual: https://undercurrentholdings.com/status/

Qué incluye el paquete

aegis-governance en PyPI es un cliente de Python para la API de AEGIS. También contiene un servidor MCP local. El paquete instala un script de consola, aegis-mcp-server. Este script inicia un servidor MCP local que utiliza el transporte stdio. El paquete no tiene ninguna otra herramienta de línea de comandos.

El servidor local no tiene motor de evaluación. De forma predeterminada, el cliente envía todas las solicitudes a la API de AEGIS alojada. El modo sandbox (el modo sin clave de API) también utiliza la API alojada. Mientras el servicio alojado esté fuera de línea, las llamadas a herramientas no devuelven evaluaciones.

Instalación

pip install "aegis-governance[mcp]"

El extra [mcp] es necesario para aegis-mcp-server. En Python < 3.10, el extra no instala nada, y aegis-mcp-server sale con una sugerencia de instalación.

Configuración local de MCP con stdio

Claude Code

claude mcp add aegis -- aegis-mcp-server

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

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

VS Code (.vscode/mcp.json):

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

Herramientas

tools/list de aegis-mcp-server en aegis-governance 1.4.2 devuelve estas seis herramientas. Sin AEGIS_API_KEY, aegis_evaluate_proposal y aegis_health llaman a la API alojada, y las otras cuatro herramientas devuelven un resultado JSON de AuthenticationError sin una llamada a la API. Con AEGIS_API_KEY configurado, las seis herramientas llaman a la API alojada.

Las descripciones a continuación están citadas del servidor. No describen un servicio que esté disponible ahora.

HerramientaDescripción (citada del servidor)
aegis_evaluate_proposalEvalúa una propuesta de ingeniería mediante las comprobaciones de puerta de AEGIS.
aegis_quick_risk_checkVerificación rápida del umbral de riesgo sin una evaluación bayesiana completa.
aegis_healthComprueba el estado de la API de AEGIS (estado del servicio, versión, componentes).
aegis_list_decisionsLista las decisiones de gobernanza recientes para el cliente autenticado.
aegis_get_decisionObtiene una decisión de gobernanza específica por ID, con detalle completo de la puerta.
aegis_get_usageObtiene el informe de uso de evaluación del cliente autenticado.

Lectura del código fuente

El repositorio fuente de aegis-governance es privado. Para leer el código fuente publicado, descargue la distribución fuente (sdist) desde PyPI:

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

O obtenga el archivo .tar.gz de los archivos de lanzamiento de PyPI.