Sentinel

Una capa de gobernanza autoalojada para servidores MCP. Sentinel se sitúa entre tus agentes de IA y las herramientas que llaman, evalúa cada solicitud según tus políticas y escribe un registro de auditoría de lo que sucedió.

Se ejecuta completamente en tu propia máquina. Postgres es la única dependencia obligatoria: sin claves de API, sin cuenta en la nube, sin llamadas a casa.

agent ──▶ Sentinel proxy ──▶ policy engine ──▶ MCP server
                                   │
                                   └──▶ audit log

Por qué existe esto

Si le das a un agente un conjunto de herramientas MCP, le has dado la capacidad de actuar. La mayoría de las configuraciones no tienen respuesta a tres preguntas:

• ¿Qué herramientas puede llamar este agente y bajo qué condiciones?

• ¿Qué hizo realmente?

• ¿Quién aprobó lo que tocó producción?

Sentinel responde a las tres con un motor de políticas que evalúa condiciones por llamada, un registro de auditoría de solo añadidura con instantáneas antes/después, y un flujo de aprobación para cualquier cosa que marques como sensible.

Qué incluye

Inicio rápido

Requiere Node 20+, pnpm y Postgres.

git clone https://github.com/gong8/sentinel-oss.git
cd sentinel-oss
cp .env.example .env        # generate secrets, point DATABASE_URL at your Postgres
pnpm setup                  # install, generate client, push schema, seed
pnpm dev

¿Necesitas Postgres? docker compose up -d postgres inicia uno.

Eso te da:

La semilla crea una organización Acme Corporation con tres usuarios e imprime sus tokens de acceso. Ejecuta pnpm db:creds en cualquier momento para volver a imprimirlos.

Apunta un agente a ello

Añade el proxy a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "sentinel": {
      "url": "http://localhost:3001/mcp",
      "headers": { "Authorization": "Bearer YOUR_ACCESS_TOKEN" }
    }
  }
}

Registra servidores ascendentes en la consola web, escribe políticas para sus herramientas y cada llamada ahora se enruta a través del motor de políticas.

Opcional: funciones de agente

Sentinel tiene un agente administrador integrado (configuración mediante chat). Necesita un LLM y admite varios proveedores, incluidos los totalmente locales, para que nunca tengas que comprar una clave de API:

• Ollama o cualquier endpoint compatible con OpenAI (LM Studio, llama.cpp, vLLM): local y gratuito

• Anthropic, OpenAI o Gemini, si prefieres traer una clave

Todo lo demás en Sentinel funciona sin ningún LLM configurado.

Arquitectura

Un monorepo de pnpm + Turborepo.

Aproximadamente 177 mil líneas de código fuente y 163 mil líneas de pruebas en 218 archivos de prueba.

La pieza más reutilizable es packages/api/src/services/policyCondition.ts: un evaluador de árboles de condiciones de ~1300 líneas sin más dependencias que Zod y un registrador. No sabe nada de MCP, Prisma ni Sentinel, y podría extraerse a cualquier proyecto que necesite expresiones de políticas.

La documentación más detallada está en docs/: comienza en docs/README.md.

Pruebas

pnpm test:unit          # no database needed
pnpm test:integration   # requires TEST_DATABASE_URL
pnpm test:security      # tenant isolation, DENY precedence
pnpm test:e2e           # Playwright
pnpm check              # format, lint, types, tests

Convenciones del proyecto

Este código base se adhiere a algunas reglas innegociables, aplicadas por la configuración de lint y los ganchos de git en .claude/hooks/:

• Sin aserciones de tipo as (excepto as const), sin any, sin @ts-ignore, sin eslint-disable

• Cada consulta a la base de datos con alcance a organizationId

• Toda entrada validada con Zod

• Credenciales cifradas antes de almacenarse

• Acciones sensibles registradas en auditoría, acciones de administración con instantáneas antes/después

• Las políticas DENY no se pueden eludir, y eso se prueba explícitamente

Consulta CLAUDE.md para la guía de desarrollo completa.

Contribuciones

Consulta CONTRIBUTING.md. Problemas de seguridad: SECURITY.md.

Licencia

GNU AGPL-3.0. Si ejecutas un Sentinel modificado como servicio de red, debes poner tus modificaciones a disposición de sus usuarios.