World Monitor
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Governance proxy for MCP servers: allowlist, forced dry run, human confirmation, blast radius, audit
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 14/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 26/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala mcp-airlock. Sigue https://mcp.popnx.com/i/shalimov04-mcp-airlock.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 13 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de mcp-airlock (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server mcp-airlock para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "airlock": { "command": "uvx", "args": [ "mcp-airlock", "--policy", "--upstream", "--env", "prod" ], "env": { "AIRLOCK_JWT_SECRET": "your-value", "AIRLOCK_SECRET": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En AIRLOCK_JWT_SECRET, AIRLOCK_SECRET deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de mcp-airlock aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
SettingsDeveloperEdit Config
{
"mcpServers": {
"airlock": {
"command": "uvx",
"args": [
"mcp-airlock",
"--policy",
"--upstream",
"--env",
"prod"
],
"env": {
"AIRLOCK_JWT_SECRET": "your-value",
"AIRLOCK_SECRET": "your-value"
}
}
}
}Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa mcp-airlock y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando mcp-airlock o muestra una herramienta de mcp-airlock en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar mcp-airlock
mcp-airlock se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar mcp-airlock
B · Otros en Otros que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de mcp-airlock (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server mcp-airlock para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user airlock --env AIRLOCK_JWT_SECRET=your-value --env AIRLOCK_SECRET=your-value -- uvx mcp-airlock --policy --upstream --env prod 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En AIRLOCK_JWT_SECRET, AIRLOCK_SECRET deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de mcp-airlock aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user airlock --env AIRLOCK_JWT_SECRET=your-value --env AIRLOCK_SECRET=your-value -- uvx mcp-airlock --policy --upstream --env prodCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Deberías ver mcp-airlock en la lista como conectado
Usa mcp-airlock y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando mcp-airlock o muestra una herramienta de mcp-airlock en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de mcp-airlock (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez) · No hay botón de un clic: pega la configuración y completa los valores tú
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server mcp-airlock para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "airlock": { "command": "uvx", "args": [ "mcp-airlock", "--policy", "--upstream", "--env", "prod" ], "env": { "AIRLOCK_JWT_SECRET": "your-value", "AIRLOCK_SECRET": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En AIRLOCK_JWT_SECRET, AIRLOCK_SECRET deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de mcp-airlock aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
~/.cursor/mcp.json
Pega esta configuración, completa los valores vacíos y guarda
{
"mcpServers": {
"airlock": {
"command": "uvx",
"args": [
"mcp-airlock",
"--policy",
"--upstream",
"--env",
"prod"
],
"env": {
"AIRLOCK_JWT_SECRET": "your-value",
"AIRLOCK_SECRET": "your-value"
}
}
}
}En la configuración de mcp-airlock, AIRLOCK_JWT_SECRET, AIRLOCK_SECRET está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa mcp-airlock y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando mcp-airlock o muestra una herramienta de mcp-airlock en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de mcp-airlock (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez) · No hay botón de un clic: pega la configuración y completa los valores tú
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server mcp-airlock para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "airlock": { "type": "stdio", "command": "uvx", "args": [ "mcp-airlock", "--policy", "--upstream", "--env", "prod" ], "env": { "AIRLOCK_JWT_SECRET": "your-value", "AIRLOCK_SECRET": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En AIRLOCK_JWT_SECRET, AIRLOCK_SECRET deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de mcp-airlock aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
MCP: Open User Configuration
Pega esta configuración, completa los valores vacíos y guarda
{
"servers": {
"airlock": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-airlock",
"--policy",
"--upstream",
"--env",
"prod"
],
"env": {
"AIRLOCK_JWT_SECRET": "your-value",
"AIRLOCK_SECRET": "your-value"
}
}
}
}En la configuración de mcp-airlock, AIRLOCK_JWT_SECRET, AIRLOCK_SECRET está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa mcp-airlock y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando mcp-airlock o muestra una herramienta de mcp-airlock en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user airlock --env AIRLOCK_JWT_SECRET=your-value --env AIRLOCK_SECRET=your-value -- uvx mcp-airlock --policy --upstream --env prodClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"airlock": {
"command": "uvx",
"args": [
"mcp-airlock",
"--policy",
"--upstream",
"--env",
"prod"
],
"env": {
"AIRLOCK_JWT_SECRET": "your-value",
"AIRLOCK_SECRET": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"airlock": {
"command": "uvx",
"args": [
"mcp-airlock",
"--policy",
"--upstream",
"--env",
"prod"
],
"env": {
"AIRLOCK_JWT_SECRET": "your-value",
"AIRLOCK_SECRET": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"airlock": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-airlock",
"--policy",
"--upstream",
"--env",
"prod"
],
"env": {
"AIRLOCK_JWT_SECRET": "your-value",
"AIRLOCK_SECRET": "your-value"
}
}
}
}AIRLOCK_JWT_SECRET secreto obligatorio envAIRLOCK_SECRET secreto obligatorio envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
pypi: mcp-airlockSegún cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub Shalimov04, dueña del repo
Último cambio de código: hace 12 días
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Sin entradas en OSV.dev para mcp-airlock@0.2.0
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/shalimov04-mcp-airlock)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: AIRLOCK_JWT_SECRET, AIRLOCK_SECRET
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hace 12 días, y la última versión (0.2.0) llegó al registro hace 2 meses.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.
En la misma categoría: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Manage monitors, status pages, incidents and maintenances in your openstatus workspace.
Validate oh-my-posh configurations and segment snippets against the official schema.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.
| Este mcp-airlock | World Monitor | openstatus | Oh My Posh Validator | Strata | Jitsu | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada |
| Necesita clave | Sí | No | No | No | No | No |
| Se añade con + en Claude | No | No | No | No | No | No |
| Revisiones básicas | 3/3 | 4/4 | 4/4 | 4/4 | 1/4 | 4/4 |
| Licencia | MIT | AGPL-3.0 | AGPL-3.0 | MIT | Apache-2.0 | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
mcp-airlock is a proxy you put between an AI agent and an MCP server when the server can do things you don't want an agent doing on its own. It speaks the 2026-07-28 revision of the protocol (the stateless one: no session, no initialize, one POST per request) and adds the parts the protocol leaves to you: who is allowed to call what, dry runs by default, a human in the loop for dangerous calls, an audit trail and tracing.
It is deliberately small. There is no UI, no policy language beyond flat YAML, no MCP SDK of its own. The whole proxy is one Starlette app plus a few helper modules.
The agent sends a normal tools/call to the proxy instead of the server. The proxy:
Authorization: Bearer) or, if you run it behind a gateway that already did the authentication, from an X-Airlock-Principal header. It is never taken from the request body. No principal, no call. A name that is blank or has whitespace around it is no principal either, from either source: trimmed, alice would be alice.delete_service can be free in dev and gated in prod.L0 (read) goes straight through.L1 (suggest) always goes through with dry_run: true, whatever the agent asked for.L2 (confirm) goes through with dry_run: true first, and the result comes back to the agent as input_required with a description of what would happen and a signed requestState. When a person says yes, the agent repeats the call with that state and the proxy executes it for real, once. Repeating it again is refused.L3 (auto) goes through as sent.Refusals come back as tool results with isError: true, not as protocol errors, so the model sees why and can do something else. Every tools/call result, a pending one included, carries the verdict and the rule that produced it in _meta. The io.mcp-airlock/ keys there are the proxy's alone: any the upstream puts into a result, one of its content blocks, a tools/list answer or a tool in it are removed before the proxy adds its own, and any the client sends are removed before the call is forwarded.
The proxy accepts three methods: tools/call as above, tools/list and server/discover. A tools/list answer is cut down to the tools the policy lists for the caller (the number of hidden tools is in _meta["io.mcp-airlock/hidden_tools"]), then checked against the pins and scanned for injection phrases. Any other method is refused with METHOD_NOT_FOUND.
-32011 (PRINCIPAL_REQUIRED) when there is no JWT and no trusted X-Airlock-Principal header.-32601 (METHOD_NOT_FOUND) for anything but tools/call, tools/list and server/discover. A legacy initialize has no _meta envelope and gets HTTP 400 / -32602 instead.-32700, -32600, -32602, -32020, all HTTP 400, and -32601/404) are answered before the missing-principal 401, so an unauthenticated client can tell a malformed request from a refused one. These cover the 2026-07-28 _meta envelope and the Mcp-Method/Mcp-Name header checks.al1. prefix is forwarded as upstream state, so a token that lost its al1. prefix is treated as a new call.From PyPI, as a tool or a package:
uvx mcp-airlock --help
pip install mcp-airlock
Three features are extras, so the base install stays small:
| Extra | Brings | Needed for |
|---|---|---|
postgres | psycopg, psycopg-pool | AIRLOCK_STORE_DSN, AIRLOCK_AUDIT_DSN, airlock-audit query --dsn |
otlp | the OTLP HTTP span exporter | OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_TRACES_ENDPOINT |
regex | google-re2 | a where rule with regex |
uvx --from 'mcp-airlock[postgres,otlp,regex]' mcp-airlock ...
pip install 'mcp-airlock[postgres,otlp,regex]'
A DSN without the postgres extra stops the proxy at startup with that hint. An OTLP endpoint without the otlp extra is a startup warning (an error under --strict) and the proxy runs without exporting. A policy with a regex rule does not load without the regex extra and says to install it. google-re2 ships wheels for glibc 2.27+ Linux, macOS and Windows, but none for musl (Alpine).
The container image ghcr.io/shalimov04/mcp-airlock includes all three extras. It listens on 0.0.0.0:9000, runs as a non-root user and has /data as its working directory, so audit.jsonl lands there. The user is uid 65532, so a host directory bind-mounted at /data has to be writable by that uid (chown 65532 ./data), or the start stops with a Permission denied message for the audit file. Each release is tagged with its version and its major.minor (X.Y.Z and X.Y).
From a checkout, uv sync --all-extras installs everything including the test tools.
The released version, no clone needed:
AIRLOCK_TRUST_PRINCIPAL_HEADER=1 uvx mcp-airlock --policy policy.yaml --upstream http://127.0.0.1:8080/mcp --env prod
The same as a container:
docker run --rm -p 127.0.0.1:9000:9000 -e AIRLOCK_TRUST_PRINCIPAL_HEADER=1 \
-v $PWD/policy.yaml:/data/policy.yaml \ --add-host=host.docker.internal:host-gateway \ ghcr.io/shalimov04/mcp-airlock:0.4 --policy policy.yaml --upstream http://host.docker.internal:8080/mcp --env prod
AIRLOCK_TRUST_PRINCIPAL_HEADER=1 takes the caller from an X-Airlock-Principal: alice header, which is fine on a laptop; anywhere shared use a JWT instead (see Environment variables). With no identity set, every call is 401.
--add-host gives Docker Engine on Linux the host.docker.internal name that Docker Desktop provides by itself. The upstream has to listen on an address the container can reach, not only on 127.0.0.1, and a host firewall may need to allow traffic from docker0; --network host with --upstream http://127.0.0.1:8080/mcp sidesteps both.
The image has a HEALTHCHECK that asks http://127.0.0.1:9000/healthz with python every 30 seconds (the image has no curl), ignoring any HTTP_PROXY. If you pass --port, or a --host bound to a specific non-loopback address, override it with --health-cmd or a compose healthcheck:. Its --start-interval needs Docker Engine 25+ (older ones ignore it). Kubernetes ignores the check: point a liveness probe at /healthz and a readiness probe at /readyz, as the Helm chart does.
From a checkout:
uv sync --all-extras
uv run pytest uv run python demo.py
The demo starts a fake upstream with a handful of tools on port 9001 and the proxy on 9000, walks through the interesting cases (refused tool, forced dry run, confirmation, replay, blast radius, output cap, injection marking) and leaves the audit log and spans in examples/.
The short version, recorded against that same fake upstream. An agent tries to delete a production service, gets a dry run and a confirmation prompt instead, the confirmation works exactly once, and a poisoned read result comes back flagged:
docs/make_demo_gif.py re-records it (uv run --with pillow python docs/make_demo_gif.py).
docs/clients.md shows how to point Claude Code and Cursor at the proxy, what the agent sees when a call is refused or held for confirmation, and which clients have been tested with the confirmation prompt.
Against a real server:
uv run mcp-airlock --policy policy.example.yaml --env prod \
--upstream http://127.0.0.1:9001/mcp --audit audit.jsonl
There are ready-made policies for the GitHub, Grafana, Kubernetes and Postgres MCP servers in examples/policies/. They were written against the servers' source at a pinned commit, so check them against your actual server before trusting them:
uv run airlock-policy lint examples/policies/github.yaml
uv run airlock-policy diff examples/policies/github.yaml --upstream http://127.0.0.1:8080/mcp --env prod
lint needs no network. It reports a tool without tiers (no_tiers, an error), a write tool without a description (no_description), a count_arg that relies on the global blast radius (blast_radius_default), a where rule for an environment no tier mentions (where_env_unknown) and an environment no tool covers (env_unused); --env adds environments that must be covered. A policy without environment lints with the first --env (or AIRLOCK_ENV) as its environment, the way the proxy would run it; without either it is an error. diff and pin take --env, then AIRLOCK_ENV, then the policy's own environment. A policy that cannot be read or does not validate is ERROR invalid in all three commands, and an upstream that does not answer tools/list like an MCP server is ERROR upstream. diff asks the server itself (not the proxy, which hides unlisted tools) for tools/list and tells you which allowlisted tools the server no longer has (missing_upstream, an error), which L1/L2 tools have no dry_run argument (no_dry_run), which where rules name an argument that is not in the schema (where_unknown_arg) and which server tools the policy does not mention (not_allowlisted). With --pins it also checks the pins. Both exit 1 when any finding is an error.
There is a small Helm chart in charts/mcp-airlock/ (Deployment, Service, a ConfigMap for the policy, a Secret for the keys, probes on /healthz and /readyz, a hardened security context). There is no chart repository, so install it from a checkout:
helm install airlock charts/mcp-airlock \
--set upstream=http://my-mcp-server:8080/mcp --set environment=prod \ --set-file policy=policy.yaml
The values are documented in charts/mcp-airlock/values.yaml. The points that matter:
AIRLOCK_JWT_SECRET and keeps it across upgrades. Read it with kubectl get secret airlock-mcp-airlock -o jsonpath='{.data.AIRLOCK_JWT_SECRET}' | base64 -d and sign HS256 tokens with sub and exp. Anyone who can read Secrets in the namespace (or the Helm release Secrets) can mint any principal. For JWKS set env.AIRLOCK_JWKS_URL and env.AIRLOCK_JWT_AUDIENCE, and set generateJwtSecret=false so no unused secret is generated. For a trusted gateway header set generateJwtSecret=false and env.AIRLOCK_TRUST_PRINCIPAL_HEADER=1, and make sure only the gateway can reach the Service: the chart ships no NetworkPolicy.AIRLOCK_UPSTREAM_AUTH, `AIRLOCK_APPROV