MCP Airlock
MCP Airlock
Puerta de enlace de seguridad de confianza cero para herramientas MCP. MCP Airlock convierte cada llamada a una herramienta en una decisión de capacidad de corta duración y vinculada al contexto, con procedencia a prueba de manipulaciones.
Por qué existe esto
Los ecosistemas de herramientas de agentes están fallando en un límite crítico: el salto del texto de prompt no confiable a la ejecución de herramientas privilegiadas.
Los patrones actuales suelen ser uno de los siguientes:
listas de permitidos estáticas (
el agente puede llamar a la herramienta X)filtrado débil mediante expresiones regulares
registros post-hoc sin garantías de integridad
Fallan cuando la inyección de prompts muta la intención a mitad de la sesión, provocando una escalada de privilegios silenciosa o la exfiltración de datos.
MCP Airlock resuelve esto con una primitiva faltante para MCP:
Arrendamientos de capacidad (Capability Leases): derechos de corta duración, firmados y vinculados al contexto (
sesión + intención + alcance de la herramienta + restricciones)Política consciente del contexto: autorización dinámica en cada llamada (puntuación de riesgo + restricciones de la herramienta + comprobaciones de arrendamiento)
Procedencia a prueba de manipulaciones: cadena de hash de solo adición para todas las decisiones de permitir/denegar
Related MCP server: mcp-permission-server
Innovación principal
Arrendamientos de capacidad vinculados al contexto (CBCL)
Cada llamada a una herramienta se autoriza frente a un arrendamiento firmado:
Vinculado a
session_idVinculado a
intent_hashLimitado a herramientas específicas
Con límite de tiempo
Restricciones opcionales (p. ej., dominios permitidos, riesgo máximo)
Si una inyección de prompt intenta cambiar la intención o saltar el alcance de la herramienta, se deniega la ejecución.
Arquitectura
flowchart LR
A[Agent / MCP Client] -->|tools/call| B[MCP Airlock Server]
B --> C[Risk Engine]
B --> D[Capability Verifier]
B --> E[Policy Engine]
E -->|allow| F[Tool Adapter Layer]
E -->|deny| G[Policy Deny Response]
F --> H[External APIs / Internal Services]
B --> I[Provenance Ledger Hash Chain]Límites de confianza
flowchart TB
subgraph Untrusted
U1[Prompt Content]
U2[Agent Reasoning Trace]
end
subgraph Trusted Control Plane
T1[MCP Airlock]
T2[Policy + Lease Validation]
T3[Signed Provenance Ledger]
end
subgraph External Targets
X1[Public APIs]
X2[Internal APIs]
end
U1 --> T1
U2 --> T1
T1 --> T2
T2 --> X1
T2 --> X2
T1 --> T3Características clave
Servidor MCP stdio compatible con
initialize,tools/list,tools/callHerramienta de emisión de capacidad:
airlock_issue_capabilityHerramienta de análisis de uso de agente/API:
airlock_usage_statsHerramienta de medición de exposición de API:
airlock_exposure_reportMiddleware de aplicación de políticas con umbrales de riesgo por herramienta
Puntuación de firmas de inyección de prompts
Adaptador de herramientas HTTP resistente a SSRF (
http_get_json)Ejemplo de integración de API real (
weather_hourly)Registro de procedencia a prueba de manipulaciones + comando de verificación
Guía de endurecimiento de sandbox para seguridad de API de agentes
CLI para serve/demo/issue/verify/stats/exposure
Inicio rápido de 2 minutos
git clone https://github.com/lara-muhanna/mcp-airlock
cd mcp-airlock
python -m pip install -e .
python -m mcp_airlock --config examples/airlock.config.json demoLo que verá:
un resumen amigable para humanos (handshake, capacidad, permitir/denegar, integridad de auditoría)
llamada maliciosa denegada con razones en lenguaje sencillo
evidencia de procedencia firmada
Demo local de un comando (sin instalación)
python -m mcp_airlock --config examples/airlock.config.json demo --city Austin --state TexasPara cargas útiles JSON completas durante la demo:
python -m mcp_airlock --config examples/airlock.config.json demo --rawEjecutar como servidor MCP
python -m mcp_airlock --config examples/airlock.config.json serveEjemplos de configuración de cliente MCP:
CLI
# Issue a capability directly
python -m mcp_airlock --config examples/airlock.config.json issue \
--session-id sess-123 \
--subject agent:planner \
--tools weather_hourly,http_get_json \
--intent "Plan safe outdoor activities" \
--ttl-seconds 900 \
--constraints '{"allowed_domains":["api.open-meteo.com"],"max_risk":0.6}'
# Verify audit integrity
python -m mcp_airlock --config examples/airlock.config.json verify-log
# API usage stats by agent
python -m mcp_airlock --config examples/airlock.config.json stats --lookback-hours 24
# API exposure measurement
python -m mcp_airlock --config examples/airlock.config.json exposure --lookback-hours 24Ejemplo de integración de agente
Ejecute:
python examples/agent_integration.pyEste script:
inicia Airlock sobre stdio
negocia el initialize/list de MCP
emite un arrendamiento
ejecuta una llamada de herramienta normal
ejecuta una llamada inyectada que es bloqueada
Plantilla de configuración
examples/airlock.config.json
{
"secret_key": "dev-secret-change-this-before-production",
"provenance_log": "./airlock-provenance.log",
"max_ttl_seconds": 1800,
"default_risk_threshold": 0.55,
"tools": {
"weather_hourly": {
"require_capability": true,
"risk_threshold": 0.7
},
"http_get_json": {
"require_capability": true,
"risk_threshold": 0.45,
"allowed_domains": ["api.open-meteo.com", "geocoding-api.open-meteo.com"]
}
}
}Resumen del modelo de seguridad
El agente solicita un arrendamiento mediante
airlock_issue_capability.El arrendamiento está firmado con HMAC e incluye
session,intent_hash,tool_scope,expiry.Cada solicitud de
tools/callincluye_capabilityy_context.Airlock aplica:
validez del arrendamiento + firma
continuidad de sesión e intención
umbral de riesgo
restricciones específicas de la herramienta (p. ej., lista de permitidos de dominio)
La decisión + evidencia se encadena mediante hash al registro de procedencia.
Estructura del proyecto
mcp-airlock/
mcp_airlock/
cli.py
server.py
policy.py
capability.py
risk.py
provenance.py
config.py
tool_ids.py
tools/
http_json.py
weather.py
examples/
airlock.config.json
agent_integration.py
docs/
CLIENT_SETUP.md
SANDBOXING_AGENTIC_APIS.mdHoja de ruta
Modo proxy MCP ascendente (envuelve servidores MCP existentes de forma transparente)
Backend de políticas OPA/Rego
Trazas de OpenTelemetry + sumideros SIEM
Broker de capacidad gestionado + rotación de claves
Paquete de reproducción firmado para respuesta a incidentes
Comunidad
Guía de contribución:
CONTRIBUTING.mdPolítica de seguridad:
SECURITY.mdCódigo de conducta:
CODE_OF_CONDUCT.mdLista de verificación de lanzamiento:
docs/RELEASE_CHECKLIST.md
Licencia
MIT
Available Tools
4 toolsairlock_audit_tailC
Read recent signed provenance events.
Inputs: limit.
airlock_issue_capabilityC
Issue a short-lived capability lease bound to session+intent.
Inputs: session_id (required), subject (required), tools (required), intent (required), +2 more.
http_get_jsonA
Fetch JSON from a public HTTPS API endpoint.
Inputs: url (required), query.
weather_hourlyA
Resolve US city/state and fetch hourly weather from Open-Meteo.
Inputs: city (required), state (required), hours.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct function (provenance auditing, capability issuance, generic HTTP fetching, and weather retrieval) with minimal overlap. An agent can easily distinguish when to use each based on the task requirements.
Mixed naming patterns: two tools use 'airlock_' prefix with verbs (issue, audit_tail), while others use 'http_' prefix or no prefix (weather_hourly). The weather tool breaks the verb-first convention used by others, using a noun-adjective pattern instead.
Four tools is acceptably compact but the set suffers from scope confusion, mixing core Airlock security functions with unrelated utility tools (weather, HTTP). This feels like two different servers merged together rather than a cohesive toolset.
The Airlock domain (capability management) is severely underdeveloped, offering only issuance and audit tail reading without revocation, validation, or capability listing. The utility tools (weather, HTTP) are also minimal, offering only hourly forecasts and GET requests without parameter customization.
Maintenance
Related MCP Connectors
MCP gateway with runtime security policy, tool-call-level control, and audit of agent actions.
Find, vet, and run MCP tools through a secure audited gateway with prompt-injection risk scoring
Real-time prompt injection filtering, MCP payload inspection, and A2A trust scoring.
Zero-secret MCP gateway for AI agents: risk-scored, audited calls with human-in-the-loop approval.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables secure interaction between LLMs and MCP tools by applying zero-trust security controls, including sensitive data masking, file system protection, and policy enforcement.MIT
- AlicenseNot gradedqualityCmaintenanceEnforces fine-grained, context-aware access control on MCP tool calls, with a tamper-evident, replayable audit log that records denials and verifies every decision.MIT
- FlicenseNot gradedqualityCmaintenanceEnables LLM agents to enforce security policies by authorizing tool calls, scanning for prompt injection, checking memory writes, redacting PII, and accessing audit trails through MCP.-
- AlicenseNot gradedqualityCmaintenanceEnables production-hardened MCP tool serving with OAuth 2.1 audience-restricted tokens, purpose-bound tools, human-in-the-loop approvals, containment, and audit trails for AI agents.Apache 2.0