@aimarket/warden 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to `@aimarket/warden`.
 
+## 0.5.0 — 2026-09-03
+
+stdio MCP server for Glama / Claude Desktop / Cursor (`warden-mcp` / `node dist/mcp-server.js`).
+Six tools with TDQS-oriented definitions (title, when-to-use / when-not naming siblings, MCP
+annotations, per-parameter descriptions, `outputSchema`). Dockerfile + `glama.json`. No secrets,
+no npm runtime dependencies. The process inspects a `tools/list` dump; it does not launch the
+server under scan.
+
 ## 0.4.0 — 2026-08-24
 
 Calibrated against the ecosystem, not against fixtures. WARDEN was pointed at every public MCP

package/README-es.md

@@ -1,23 +1,42 @@
-# WARDEN — cortafuegos de seguridad para MCP
+# WARDEN — servidor MCP
+
+<!-- mcp-name: io.github.alexar76/warden -->
 
 <!-- aicom-readme-badges -->
 <p align="center">
   <a href="https://github.com/alexar76/warden/actions/workflows/ci.yml"><img src="docs/badges/ci.svg" alt="CI" /></a>
-  <a href="https://www.npmjs.com/package/@aimarket/warden"><img src="https://img.shields.io/npm/v/@aimarket/warden?color=cb3837&label=npm" alt="npm version" /></a>
+  <a href="https://glama.ai/mcp/servers/alexar76/warden"><img src="https://glama.ai/mcp/servers/alexar76/warden/badges/score.svg" alt="warden MCP server" /></a>
+  <a href="https://warden.modelmarket.dev/"><img src="https://img.shields.io/npm/v/@aimarket/warden?color=cb3837&label=npm" alt="npm version" /></a>
   <img src="docs/badges/deps.svg" alt="Cero dependencias de ejecución" />
-  <img src="docs/badges/tests.svg" alt="141 pruebas en verde" />
+  <img src="docs/badges/tests.svg" alt="166 pruebas en verde" />
   <img src="docs/badges/node.svg" alt="Node >= 20" />
   <a href="LICENSE"><img src="docs/badges/license.svg" alt="Licencia: MIT" /></a>
 </p>
 <!-- /aicom-readme-badges -->
 
 <p align="center">
-  <img src="docs/assets/hero.svg" alt="WARDEN — MCP security firewall: tool defs pass static-scan, threat-feed, origin, and pinning before a recorded verdict" width="920" />
+  <a href="https://warden.modelmarket.dev/">
+    <img src="docs/screenshots/readme/hero-3d.png" alt="WARDEN — cadena 3D de puertas: tools/list por static-scan, threat-feed, origin y pinning hasta un veredicto registrado" width="100%" />
+  </a>
 </p>
 
 
 > 🌐 [English](README.md) · [Русский](README-ru.md) · **Español** · [Français](README-fr.md) · [中文](README-zh.md) · [Glosario](https://github.com/alexar76/aicom/blob/main/docs/localization-glossary.md)
 
+**Un servidor MCP. Cortafuegos de las definiciones de herramienta anunciadas. Biblioteca incluida.**
+
+Transporte: **stdio** (`npx -y @aimarket/warden` / `node dist/mcp-server.js`). Hosts compatibles:
+Claude Desktop, Cursor, Glama y cualquier cliente MCP con stdio. Sin claves.
+
+| | |
+|------|----------|
+| Entrada MCP (stdio) | `warden-mcp` → [`src/mcp-server.ts`](src/mcp-server.ts) |
+| Herramientas | `vet_mcp_server`, `static_scan_tools`, `classify_sensitive_tools`, `check_egress_url`, `canonicalize_json`, `list_scan_rules` |
+| Biblioteca | `import { Warden } from "@aimarket/warden"` |
+| Glama / Docker (stdio) | [`Dockerfile`](Dockerfile), [`glama.json`](glama.json) |
+| Official MCP Registry | [`server.json`](server.json) → `io.github.alexar76/warden` |
+| Smithery | [`smithery.yaml`](smithery.yaml) |
+
 Un servidor MCP le dice a tu agente qué hacen sus herramientas. El agente se lo cree — y esa frase
 es la superficie de ataque. La descripción de una herramienta es texto de prompt que un tercero
 entrega directamente al contexto de tu modelo, y un campo de esquema llamado `api_key` es una
@@ -27,15 +46,56 @@ WARDEN examina un servidor **antes de que ninguna de sus herramientas llegue al
 un veredicto que puedes registrar: permitir/bloquear, una puntuación 0..1, los hallazgos que la
 produjeron, una partición por herramienta y la tabla de reglas exacta que estaba en vigor.
 
+**Cero dependencias npm de ejecución.** El único import de la biblioteca es `node:crypto`. El
+servidor MCP stdio añade otros builtins `node:` (`fs`, `path`, `process`) y sigue sin traer paquetes.
+Es el cortafuegos de [ARGUS](https://github.com/alexar76/argus), extraído para que puedas ponerlo
+delante de tu propio host MCP sin adoptar un agente.
+
+## Ejecutar como servidor MCP (stdio)
+
 ```bash
-npm install @aimarket/warden
+npx -y @aimarket/warden
+npm run build && node dist/mcp-server.js
+```
+
+Claude Desktop / Cursor (`mcpServers`):
+
+```json
+{
+  "mcpServers": {
+    "warden": {
+      "command": "npx",
+      "args": ["-y", "@aimarket/warden"]
+    }
+  }
+}
 ```
 
-**Cero dependencias de ejecución.** El único import de todo el paquete es `node:crypto`. Es el
-cortafuegos de [ARGUS](https://github.com/alexar76/argus), extraído para que puedas ponerlo delante
-de tu propio host MCP sin adoptar un agente.
+El proceso **no** arranca, no hace de proxy ni aísla otro servidor MCP: pasas un dump de
+`tools/list` y recibes un veredicto.
+
+| Herramienta | Cuándo usarla |
+|---|---|
+| `vet_mcp_server` | Cadena completa de puertas |
+| `static_scan_tools` | Solo el escaneo estático |
+| `classify_sensitive_tools` | Partición por globs del operador |
+| `check_egress_url` | Allowlist de hosts (lista vacía = denegar todos) |
+| `canonicalize_json` | Bytes RFC 8785 |
+| `list_scan_rules` | Tabla de reglas publicada |
+
+### Publicar en Glama
+
+Listado: **[glama.ai/mcp/servers/alexar76/warden](https://glama.ai/mcp/servers/alexar76/warden)**
 
-## Inicio rápido
+El mismo patrón que [ARGUS](https://github.com/alexar76/argus) y
+[aimarket-mcp](https://github.com/alexar76/aimarket-mcp): [`glama.json`](glama.json) +
+[`Dockerfile`](Dockerfile) + `node dist/mcp-server.js`. Formulario: [`docs/GLAMA.md`](docs/GLAMA.md).
+
+## Biblioteca (incrustar en tu host)
+
+```bash
+npm install @aimarket/warden
+```
 
 ```ts
 import { Warden, ThreatFeed, silentLogger } from "@aimarket/warden";
@@ -159,6 +219,9 @@ degradar a ninguna protección:
 | [El threat feed firmado](docs/threat-feed.es.md) | El contrato en el cable, las tres comprobaciones y cómo publicar un feed que WARDEN acepte |
 | [Guía de integración](docs/integration.es.md) | Cómo conectar WARDEN a tu propio host MCP, elecciones de política y qué registrar |
 | [Estudio de campo: 1 108 servidores MCP públicos](docs/mcp-survey.es.md) | Qué decidió WARDEN sobre definiciones de herramienta reales de terceros — 50 servidores bloqueados, 4 sustentados, y las seis formas en que el resto se equivocó |
+| [Glama / Docker](docs/GLAMA.md) | MCP stdio, health check, Build steps / CMD |
+| [Security](SECURITY.md) | Cómo informar de un bypass del cortafuegos |
+| [Contributing](CONTRIBUTING.md) | Regla de cero dependencias, PRs de la tabla de reglas |
 
 ## Lo que esto no es
 
@@ -173,11 +236,13 @@ degradar a ninguna protección:
   `test/no-phantom-gate.test.ts` falla si alguna puerta vuelve a declarar inalcanzabilidad.
 - **No sustituye a leer las definiciones de herramientas.** 11 registros integrados de amenazas son
   un suelo, no un catálogo.
+- **No es un proxy.** La entrada MCP stdio inspecciona las definiciones que le pasas. No se conecta
+  al servidor bajo examen, no lo descarga ni lo ejecuta.
 
 ## Desarrollo
 
 ```bash
-npm install && npm run build && npm test   # 141 pruebas
+npm install && npm run build && npm test   # 166 pruebas
 ```
 
 `test/packaging.test.ts` es lo que mantiene honesto el titular: falla si aparece una dependencia de

package/README-fr.md

@@ -1,23 +1,42 @@
-# WARDEN — pare-feu de sécurité MCP
+# WARDEN — serveur MCP
+
+<!-- mcp-name: io.github.alexar76/warden -->
 
 <!-- aicom-readme-badges -->
 <p align="center">
   <a href="https://github.com/alexar76/warden/actions/workflows/ci.yml"><img src="docs/badges/ci.svg" alt="CI" /></a>
-  <a href="https://www.npmjs.com/package/@aimarket/warden"><img src="https://img.shields.io/npm/v/@aimarket/warden?color=cb3837&label=npm" alt="version npm" /></a>
+  <a href="https://glama.ai/mcp/servers/alexar76/warden"><img src="https://glama.ai/mcp/servers/alexar76/warden/badges/score.svg" alt="warden MCP server" /></a>
+  <a href="https://warden.modelmarket.dev/"><img src="https://img.shields.io/npm/v/@aimarket/warden?color=cb3837&label=npm" alt="version npm" /></a>
   <img src="docs/badges/deps.svg" alt="Zéro dépendance d'exécution" />
-  <img src="docs/badges/tests.svg" alt="141 tests au vert" />
+  <img src="docs/badges/tests.svg" alt="166 tests au vert" />
   <img src="docs/badges/node.svg" alt="Node >= 20" />
   <a href="LICENSE"><img src="docs/badges/license.svg" alt="Licence : MIT" /></a>
 </p>
 <!-- /aicom-readme-badges -->
 
 <p align="center">
-  <img src="docs/assets/hero.svg" alt="WARDEN — MCP security firewall: tool defs pass static-scan, threat-feed, origin, and pinning before a recorded verdict" width="920" />
+  <a href="https://warden.modelmarket.dev/">
+    <img src="docs/screenshots/readme/hero-3d.png" alt="WARDEN — chaîne 3D de portes : tools/list via static-scan, threat-feed, origin et pinning jusqu’à un verdict enregistré" width="100%" />
+  </a>
 </p>
 
 
 > 🌐 [English](README.md) · [Русский](README-ru.md) · [Español](README-es.md) · **Français** · [中文](README-zh.md) · [Glossaire](https://github.com/alexar76/aicom/blob/main/docs/localization-glossary.md)
 
+**Un serveur MCP. Pare-feu des définitions d'outils annoncées. Bibliothèque incluse.**
+
+Transport : **stdio** (`npx -y @aimarket/warden` / `node dist/mcp-server.js`). Hôtes compatibles :
+Claude Desktop, Cursor, Glama et tout client MCP en stdio. Aucune clé.
+
+| | |
+|------|----------|
+| Entrée MCP (stdio) | `warden-mcp` → [`src/mcp-server.ts`](src/mcp-server.ts) |
+| Outils | `vet_mcp_server`, `static_scan_tools`, `classify_sensitive_tools`, `check_egress_url`, `canonicalize_json`, `list_scan_rules` |
+| Bibliothèque | `import { Warden } from "@aimarket/warden"` |
+| Glama / Docker (stdio) | [`Dockerfile`](Dockerfile), [`glama.json`](glama.json) |
+| Official MCP Registry | [`server.json`](server.json) → `io.github.alexar76/warden` |
+| Smithery | [`smithery.yaml`](smithery.yaml) |
+
 Un serveur MCP indique lui-même à votre agent ce que font ses outils. L'agent le croit — et cette
 phrase est la surface d'attaque. La description d'un outil est du texte de prompt qu'un tiers livre
 directement dans le contexte de votre modèle, et un champ de schéma nommé `api_key` est une demande
@@ -27,15 +46,56 @@ WARDEN examine un serveur **avant qu'aucun de ses outils n'atteigne le modèle**
 que vous pouvez consigner : autoriser/bloquer, un score 0..1, les constats qui l'ont produit, une
 partition par outil et la table de règles exacte qui était en vigueur.
 
+**Zéro dépendance npm d'exécution.** Le seul import de la bibliothèque est `node:crypto`. Le serveur
+MCP stdio ajoute d'autres builtins `node:` (`fs`, `path`, `process`) et ne tire toujours aucun paquet.
+C'est le pare-feu d'[ARGUS](https://github.com/alexar76/argus), extrait pour que vous puissiez le
+placer devant votre propre hôte MCP sans adopter d'agent.
+
+## Lancer comme serveur MCP (stdio)
+
 ```bash
-npm install @aimarket/warden
+npx -y @aimarket/warden
+npm run build && node dist/mcp-server.js
+```
+
+Claude Desktop / Cursor (`mcpServers`) :
+
+```json
+{
+  "mcpServers": {
+    "warden": {
+      "command": "npx",
+      "args": ["-y", "@aimarket/warden"]
+    }
+  }
+}
 ```
 
-**Zéro dépendance d'exécution.** Le seul import de tout le paquet est `node:crypto`. C'est le pare-feu
-d'[ARGUS](https://github.com/alexar76/argus), extrait pour que vous puissiez le placer devant votre
-propre hôte MCP sans adopter d'agent.
+Le processus ne démarre, ne proxifie ni n'isole un autre serveur MCP : vous passez un dump
+`tools/list`, vous récupérez un verdict.
+
+| Outil | Quand l'appeler |
+|---|---|
+| `vet_mcp_server` | Chaîne complète de portes |
+| `static_scan_tools` | Scan statique uniquement |
+| `classify_sensitive_tools` | Partition par globs opérateur |
+| `check_egress_url` | Allowlist d'hôtes (liste vide = tout refuser) |
+| `canonicalize_json` | Octets RFC 8785 |
+| `list_scan_rules` | Table de règles publiée |
+
+### Publier sur Glama
+
+Listing : **[glama.ai/mcp/servers/alexar76/warden](https://glama.ai/mcp/servers/alexar76/warden)**
 
-## Démarrage rapide
+Même modèle que [ARGUS](https://github.com/alexar76/argus) et
+[aimarket-mcp](https://github.com/alexar76/aimarket-mcp) : [`glama.json`](glama.json) +
+[`Dockerfile`](Dockerfile) + `node dist/mcp-server.js`. Formulaire : [`docs/GLAMA.md`](docs/GLAMA.md).
+
+## Bibliothèque (embarquer dans votre hôte)
+
+```bash
+npm install @aimarket/warden
+```
 
 ```ts
 import { Warden, ThreatFeed, silentLogger } from "@aimarket/warden";
@@ -159,6 +219,9 @@ une absence de protection :
 | [Le threat feed signé](docs/threat-feed.fr.md) | Le contrat sur le fil, les trois vérifications, et comment publier un feed que WARDEN acceptera |
 | [Guide d'intégration](docs/integration.fr.md) | Brancher WARDEN sur votre propre hôte MCP, choix de politique, et quoi consigner |
 | [Étude de terrain : 1 108 serveurs MCP publics](docs/mcp-survey.fr.md) | Ce que WARDEN a décidé sur de vraies définitions d'outil tierces — 50 serveurs bloqués, 4 étayés, et les six façons dont le reste était faux |
+| [Glama / Docker](docs/GLAMA.md) | MCP stdio, health check, Build steps / CMD |
+| [Security](SECURITY.md) | Signaler un contournement du pare-feu |
+| [Contributing](CONTRIBUTING.md) | Règle zéro dépendance, PRs de table de règles |
 
 ## Ce que ce n'est pas
 
@@ -173,11 +236,13 @@ une absence de protection :
   `test/no-phantom-gate.test.ts` échoue si une porte déclare de nouveau une injoignabilité.
 - **Pas un substitut à la lecture des définitions d'outils.** 11 enregistrements de menaces intégrés
   sont un socle, pas un catalogue.
+- **Pas un proxy.** L'entrée MCP stdio inspecte les définitions que vous lui passez. Elle ne se
+  connecte pas au serveur examiné, ne le télécharge pas et ne l'exécute pas.
 
 ## Développement
 
 ```bash
-npm install && npm run build && npm test   # 141 tests
+npm install && npm run build && npm test   # 166 tests
 ```
 
 `test/packaging.test.ts` est ce qui tient l'accroche honnête : il échoue si une dépendance d'exécution

package/README-ru.md

@@ -1,23 +1,42 @@
-# WARDEN — файрвол безопасности MCP
+# WARDEN — MCP-сервер
+
+<!-- mcp-name: io.github.alexar76/warden -->
 
 <!-- aicom-readme-badges -->
 <p align="center">
   <a href="https://github.com/alexar76/warden/actions/workflows/ci.yml"><img src="docs/badges/ci.svg" alt="CI" /></a>
-  <a href="https://www.npmjs.com/package/@aimarket/warden"><img src="https://img.shields.io/npm/v/@aimarket/warden?color=cb3837&label=npm" alt="npm version" /></a>
+  <a href="https://glama.ai/mcp/servers/alexar76/warden"><img src="https://glama.ai/mcp/servers/alexar76/warden/badges/score.svg" alt="warden MCP server" /></a>
+  <a href="https://warden.modelmarket.dev/"><img src="https://img.shields.io/npm/v/@aimarket/warden?color=cb3837&label=npm" alt="npm version" /></a>
   <img src="docs/badges/deps.svg" alt="Zero runtime dependencies" />
-  <img src="docs/badges/tests.svg" alt="141 tests passing" />
+  <img src="docs/badges/tests.svg" alt="166 tests passing" />
   <img src="docs/badges/node.svg" alt="Node >= 20" />
   <a href="LICENSE"><img src="docs/badges/license.svg" alt="License: MIT" /></a>
 </p>
 <!-- /aicom-readme-badges -->
 
 <p align="center">
-  <img src="docs/assets/hero.svg" alt="WARDEN — MCP security firewall: tool defs pass static-scan, threat-feed, origin, and pinning before a recorded verdict" width="920" />
+  <a href="https://warden.modelmarket.dev/">
+    <img src="docs/screenshots/readme/hero-3d.png" alt="WARDEN — 3D-цепочка гейтов: tools/list через static-scan, threat-feed, origin и pinning к записанному вердикту" width="100%" />
+  </a>
 </p>
 
 
 > 🌐 [English](README.md) · **Русский** · [Español](README-es.md) · [Français](README-fr.md) · [中文](README-zh.md) · [Глоссарий](https://github.com/alexar76/aicom/blob/main/docs/localization-glossary.md)
 
+**Один MCP-сервер. Файрвол для объявленных определений инструментов. Библиотека в комплекте.**
+
+Транспорт: **stdio** (`npx -y @aimarket/warden` / `node dist/mcp-server.js`). Совместимые хосты:
+Claude Desktop, Cursor, Glama и любой MCP-клиент со stdio. Ключи не нужны.
+
+| | |
+|------|----------|
+| Точка входа MCP (stdio) | `warden-mcp` → [`src/mcp-server.ts`](src/mcp-server.ts) |
+| Инструменты | `vet_mcp_server`, `static_scan_tools`, `classify_sensitive_tools`, `check_egress_url`, `canonicalize_json`, `list_scan_rules` |
+| Библиотека | `import { Warden } from "@aimarket/warden"` |
+| Glama / Docker (stdio) | [`Dockerfile`](Dockerfile), [`glama.json`](glama.json) |
+| Official MCP Registry | [`server.json`](server.json) → `io.github.alexar76/warden` |
+| Smithery | [`smithery.yaml`](smithery.yaml) |
+
 MCP-сервер сам сообщает вашему агенту, что делают его инструменты. Агент этому верит — и вот эта
 фраза и есть поверхность атаки. Описание инструмента — это текст промпта, который третья сторона
 доставляет прямо в контекст модели, а поле схемы с именем `api_key` — это запрос ваших секретов,
@@ -27,15 +46,56 @@ WARDEN проверяет сервер **до того, как его инстр
 который можно записать: allow/block, оценку 0..1, найденные проблемы, разбиение по инструментам и
 точную таблицу правил, которая действовала в момент проверки.
 
+**Ноль npm-зависимостей в рантайме.** В библиотеке единственный импорт — `node:crypto`. stdio
+MCP-сервер добавляет другие `node:` builtins (`fs`, `path`, `process`) и по-прежнему не тянет пакеты.
+Это файрвол из [ARGUS](https://github.com/alexar76/argus), вынесенный отдельно, чтобы его можно было
+поставить перед своим MCP-хостом, не переезжая на агента.
+
+## Запуск как MCP-сервер (stdio)
+
 ```bash
-npm install @aimarket/warden
+npx -y @aimarket/warden
+npm run build && node dist/mcp-server.js
+```
+
+Claude Desktop / Cursor (`mcpServers`):
+
+```json
+{
+  "mcpServers": {
+    "warden": {
+      "command": "npx",
+      "args": ["-y", "@aimarket/warden"]
+    }
+  }
+}
 ```
 
-**Ноль рантайм-зависимостей.** Единственный импорт во всём пакете — `node:crypto`. Это файрвол из
-[ARGUS](https://github.com/alexar76/argus), вынесенный отдельно, чтобы его можно было поставить
-перед своим MCP-хостом, не переезжая на агента.
+Процесс **не** запускает, не проксирует и не изолирует чужой MCP-сервер: вы передаёте дамп
+`tools/list`, получаете вердикт.
+
+| Инструмент | Когда вызывать |
+|---|---|
+| `vet_mcp_server` | Полная цепочка гейтов |
+| `static_scan_tools` | Только static-scan |
+| `classify_sensitive_tools` | Glob-разбиение оператора |
+| `check_egress_url` | Allowlist хостов (пустой список — отказ всем) |
+| `canonicalize_json` | Байты RFC 8785 |
+| `list_scan_rules` | Опубликованная таблица правил |
+
+### Публикация на Glama
+
+Листинг: **[glama.ai/mcp/servers/alexar76/warden](https://glama.ai/mcp/servers/alexar76/warden)**
 
-## Быстрый старт
+Тот же шаблон, что у [ARGUS](https://github.com/alexar76/argus) и
+[aimarket-mcp](https://github.com/alexar76/aimarket-mcp): [`glama.json`](glama.json) +
+[`Dockerfile`](Dockerfile) + `node dist/mcp-server.js`. Форма: [`docs/GLAMA.md`](docs/GLAMA.md).
+
+## Библиотека (встроить в свой хост)
+
+```bash
+npm install @aimarket/warden
+```
 
 ```ts
 import { Warden, ThreatFeed, silentLogger } from "@aimarket/warden";
@@ -158,6 +218,9 @@ GET <ваш feed url>
 | [Подписанный threat feed](docs/threat-feed.ru.md) | Контракт на проводе, три проверки и как публиковать feed, который WARDEN примет |
 | [Руководство по интеграции](docs/integration.ru.md) | Как встроить WARDEN в свой MCP-хост, выбор политики и что записывать |
 | [Полевой обзор: 1 108 публичных MCP-серверов](docs/mcp-survey.ru.md) | Что WARDEN решил на настоящих чужих определениях инструментов — 50 серверов заблокировано, 4 подтверждено, и шесть способов, которыми остальные оказались ошибкой |
+| [Glama / Docker](docs/GLAMA.md) | stdio MCP, health check, Build steps / CMD |
+| [Security](SECURITY.md) | Как сообщать об обходе файрвола |
+| [Contributing](CONTRIBUTING.md) | Правило нулевых зависимостей, PR на таблицу правил |
 
 ## Чем это не является
 
@@ -172,11 +235,13 @@ GET <ваш feed url>
   снова заявит о недоступности.
 - **Не замена чтению определений инструментов.** 11 встроенных записей об угрозах — это минимум, а не
   каталог.
+- **Не прокси.** stdio MCP-вход смотрит на определения, которые вы ему передали. Он не
+  подключается к проверяемому серверу, не качает его и не исполняет.
 
 ## Разработка
 
 ```bash
-npm install && npm run build && npm test   # 141 тестов
+npm install && npm run build && npm test   # 166 тестов
 ```
 
 `test/packaging.test.ts` — то, что удерживает заголовок честным: он падает, если появляется

package/README-zh.md

@@ -1,37 +1,96 @@
-# WARDEN — MCP 安全防火墙
+# WARDEN — MCP 服务器
+
+<!-- mcp-name: io.github.alexar76/warden -->
 
 <!-- aicom-readme-badges -->
 <p align="center">
   <a href="https://github.com/alexar76/warden/actions/workflows/ci.yml"><img src="docs/badges/ci.svg" alt="CI" /></a>
-  <a href="https://www.npmjs.com/package/@aimarket/warden"><img src="https://img.shields.io/npm/v/@aimarket/warden?color=cb3837&label=npm" alt="npm 版本" /></a>
+  <a href="https://glama.ai/mcp/servers/alexar76/warden"><img src="https://glama.ai/mcp/servers/alexar76/warden/badges/score.svg" alt="warden MCP server" /></a>
+  <a href="https://warden.modelmarket.dev/"><img src="https://img.shields.io/npm/v/@aimarket/warden?color=cb3837&label=npm" alt="npm 版本" /></a>
   <img src="docs/badges/deps.svg" alt="零运行时依赖" />
-  <img src="docs/badges/tests.svg" alt="141 项测试通过" />
+  <img src="docs/badges/tests.svg" alt="166 项测试通过" />
   <img src="docs/badges/node.svg" alt="Node >= 20" />
   <a href="LICENSE"><img src="docs/badges/license.svg" alt="许可证：MIT" /></a>
 </p>
 <!-- /aicom-readme-badges -->
 
 <p align="center">
-  <img src="docs/assets/hero.svg" alt="WARDEN — MCP security firewall: tool defs pass static-scan, threat-feed, origin, and pinning before a recorded verdict" width="920" />
+  <a href="https://warden.modelmarket.dev/">
+    <img src="docs/screenshots/readme/hero-3d.png" alt="WARDEN — 3D 门链：tools/list 经 static-scan、threat-feed、origin、pinning 到可记录的裁定" width="100%" />
+  </a>
 </p>
 
 
 > 🌐 [English](README.md) · [Русский](README-ru.md) · [Español](README-es.md) · [Français](README-fr.md) · **中文** · [术语表](https://github.com/alexar76/aicom/blob/main/docs/localization-glossary.md)
 
+**一个 MCP 服务器。针对已广告工具定义的安全防火墙。附带库。**
+
+传输：**stdio**（`npx -y @aimarket/warden` / `node dist/mcp-server.js`）。兼容主机：Claude Desktop、
+Cursor、Glama，以及任何支持 stdio 的 MCP 客户端。不需要密钥。
+
+| | |
+|------|----------|
+| MCP 入口（stdio） | `warden-mcp` → [`src/mcp-server.ts`](src/mcp-server.ts) |
+| 工具 | `vet_mcp_server`、`static_scan_tools`、`classify_sensitive_tools`、`check_egress_url`、`canonicalize_json`、`list_scan_rules` |
+| 库 | `import { Warden } from "@aimarket/warden"` |
+| Glama / Docker（stdio） | [`Dockerfile`](Dockerfile)、[`glama.json`](glama.json) |
+| Official MCP Registry | [`server.json`](server.json) → `io.github.alexar76/warden` |
+| Smithery | [`smithery.yaml`](smithery.yaml) |
+
 MCP 服务器自己告诉你的智能体，它的工具是做什么的。智能体就信了——而这句话正是攻击面。工具描述就是第三方直接
 投递进模型上下文的提示词文本；而一个名叫 `api_key` 的 schema 字段，就是以 API 形式写出来的索要密钥的请求。
 
 WARDEN 在**该服务器的任何工具到达模型之前**审查它，并返回一份可以留档的裁定：允许/阻止、0..1 的评分、导致该
 评分的各项发现、按工具的划分，以及当时生效的确切规则表。
 
+**零 npm 运行时依赖。** 库本身唯一的 import 是 `node:crypto`。stdio MCP 服务器会再用到其他 `node:`
+内建模块（`fs`、`path`、`process`），仍然不拉任何包。它就是 [ARGUS](https://github.com/alexar76/argus)
+里的那个防火墙，被单独抽出来，好让你把它放在自己的 MCP 宿主前面，而不必换用一个智能体。
+
+## 作为 MCP 服务器运行（stdio）
+
 ```bash
-npm install @aimarket/warden
+npx -y @aimarket/warden
+npm run build && node dist/mcp-server.js
 ```
 
-**零运行时依赖。** 整个包里唯一的 import 是 `node:crypto`。它就是 [ARGUS](https://github.com/alexar76/argus)
-里的那个防火墙，被单独抽出来，好让你把它放在自己的 MCP 宿主前面，而不必换用一个智能体。
+Claude Desktop / Cursor（`mcpServers`）：
+
+```json
+{
+  "mcpServers": {
+    "warden": {
+      "command": "npx",
+      "args": ["-y", "@aimarket/warden"]
+    }
+  }
+}
+```
+
+进程**不会**启动、代理或沙箱化另一个 MCP 服务器：你传入 `tools/list` 转储，得到一份裁决。
+
+| 工具 | 何时使用 |
+|---|---|
+| `vet_mcp_server` | 完整门控链 |
+| `static_scan_tools` | 仅静态扫描 |
+| `classify_sensitive_tools` | 运营方 glob 分类 |
+| `check_egress_url` | 主机 allowlist（空列表拒绝全部） |
+| `canonicalize_json` | RFC 8785 字节 |
+| `list_scan_rules` | 已发布的规则表 |
+
+### 发布到 Glama
 
-## 快速开始
+列表页：**[glama.ai/mcp/servers/alexar76/warden](https://glama.ai/mcp/servers/alexar76/warden)**
+
+与 [ARGUS](https://github.com/alexar76/argus)、[aimarket-mcp](https://github.com/alexar76/aimarket-mcp)
+相同：[`glama.json`](glama.json) + [`Dockerfile`](Dockerfile) + `node dist/mcp-server.js`。
+表单：[`docs/GLAMA.md`](docs/GLAMA.md)。
+
+## 库（嵌入你的宿主）
+
+```bash
+npm install @aimarket/warden
+```
 
 ```ts
 import { Warden, ThreatFeed, silentLogger } from "@aimarket/warden";
@@ -146,6 +205,9 @@ GET <你的 feed url>
 | [已签名的威胁情报 feed](docs/threat-feed.zh.md) | 线上契约、三项检查，以及如何发布一个 WARDEN 会接受的 feed |
 | [集成指南](docs/integration.zh.md) | 如何把 WARDEN 接入自己的 MCP 宿主、策略取舍，以及应当留档什么 |
 | [实地普查：1 108 个公开 MCP 服务器](docs/mcp-survey.zh.md) | WARDEN 在真实的第三方工具定义上判了什么——拦截 50 个服务器，4 项成立，其余判错的六种方式 |
+| [Glama / Docker](docs/GLAMA.md) | stdio MCP、健康检查、Build steps / CMD |
+| [Security](SECURITY.md) | 如何报告防火墙绕过 |
+| [Contributing](CONTRIBUTING.md) | 零依赖规则、规则表 PR |
 
 ## 它不是什么
 
@@ -157,11 +219,12 @@ GET <你的 feed url>
   没发出的情况下报告预言机不可达。该门控已被移除，并且只要有任何门控再次声称不可达，
   `test/no-phantom-gate.test.ts` 就会失败。
 - **不能替代你亲自读工具定义。** 11 条内置威胁记录是底线，不是目录。
+- **不是代理。** stdio MCP 入口检查的是你传入的定义。它不会连接、下载或执行被扫描的服务器。
 
 ## 开发
 
 ```bash
-npm install && npm run build && npm test   # 141 项测试
+npm install && npm run build && npm test   # 166 项测试
 ```
 
 `test/packaging.test.ts` 正是让标题保持诚实的东西：一旦出现运行时依赖、任何源文件从包外 import、或者入口点不