SentinelMCP

Firewall determinista de políticas y motor de gobernanza en tiempo de ejecución para el Model Context Protocol (MCP)

Descripción general

SentinelMCP es una pasarela de seguridad de grado de producción y un marco de gobernanza en tiempo de ejecución diseñado específicamente para servidores del Model Context Protocol (MCP) y enjambres de IA multiagente [1]. A medida que los agentes de IA obtienen cada vez más acceso autónomo a sistemas de archivos, bases de datos y API empresariales a través de MCP, los riesgos de seguridad, como las inyecciones de prompts, las invocaciones no autorizadas de herramientas y la exfiltración de datos, han aumentado.

SentinelMCP actúa como un firewall de políticas en línea, interceptando llamadas a herramientas MCP JSON-RPC, inspeccionando los argumentos contra reglas declarativas basadas en AST, aplicando límites de seguridad y registrando un rastro de auditoría inmutable y criptográficamente verificable.

Related MCP server: protect-mcp

Arquitectura y características clave

• Motor de políticas como código: Definiciones de políticas declarativas en JSON/YAML que admiten coincidencia de patrones glob en nombres de herramientas, inspecciones regex en valores de argumentos y validación estricta de esquemas de argumentos [2].

• Libro de contabilidad de procedencia criptográfica: Registro de auditoría de solo añadidura donde cada registro de ejecución se encadena con hashes SHA-256, lo que garantiza una trazabilidad a prueba de manipulaciones para el cumplimiento y la auditoría.

• Pasarela proxy de alto rendimiento: Construida sobre FastAPI y Pydantic v2, ofrece una latencia de intercepción de sub-milisegundos con manejo de solicitudes asíncronas.

• Cadena de herramientas CLI y de pruebas: CLI integrada para evaluar llamadas a herramientas contra políticas, ejecutar el servidor de la pasarela y verificar la integridad del libro de contabilidad.

• CI/CD de grado empresarial: Completamente probado con pytest, probado en matriz con Python 3.11 y 3.12, e integrado con flujos de trabajo de GitHub Actions.

Instalación

Clona el repositorio e instala en modo editable con las dependencias de desarrollo:

git clone https://github.com/ateeqdesktop-dot/sentinel-mcp.git
cd sentinel-mcp
pip install -e .[dev]

Uso

1. Evaluación de una llamada a herramienta mediante CLI

Puedes probar cómo SentinelMCP evalúa cualquier llamada a herramienta MCP contra tus políticas de seguridad:

sentinel-mcp evaluate --tool fs_delete --args '{"path": "/home/user/document.txt"}' --policy policy.json

2. Ejecución del servidor de la pasarela

Inicia el servidor proxy de SentinelMCP localmente:

sentinel-mcp serve --host 127.0.0.1 --port 8000 --policy policy.json

3. Verificación de la integridad del libro de contabilidad de auditoría

Verifica que el rastro de auditoría de solo añadidura no haya sido manipulado:

sentinel-mcp verify --ledger sentinel_audit.jsonl

Ejemplo de configuración de políticas (policy.json)

{
  "version": "1.0",
  "default_action": "allow",
  "rules": [
    {
      "id": "block-destructive-fs",
      "tool_pattern": "fs_*",
      "action": "deny",
      "forbidden_arguments": [
        "rm\\s+-rf",
        "/etc/passwd",
        "drop\\s+database"
      ]
    },
    {
      "id": "limit-sql-queries",
      "tool_pattern": "db_*",
      "action": "allow",
      "max_string_length": 500
    }
  ]
}

Pruebas

Ejecuta la suite de pruebas con pytest y cobertura de código:

pytest --cov=sentinel tests/ -v

Licencia

Distribuido bajo la Licencia MIT. Consulta LICENSE para obtener más información.

Referencias

1. Especificación del Model Context Protocol (MCP) de Anthropic. Disponible en línea.

2. Principios de Open Policy Agent (OPA) para la seguridad nativa de la nube. Disponible en línea.