Skip to main content
Glama
AAH20

io.github.AAH20/agent-action-gate

by AAH20

Agent Action Gate

Gate/Prove среда выполнения для вызовов инструментов агентов и MCP.

Нормализация намерения инструмента → отклонение неизвестных → никогда не считайте уверенность модели одобрением → HITL-подтверждение для разрушительных / предоставления / вывода из эксплуатации → Action Ledger (хэш-цепочка).

Извлечено из GRC_Claw @grc-claw/agent-policy-firewall. Этот репозиторий — острый срез кузницы: одна команда, без собора.

Коммерческое (как это продается): $499 Instant Audit и консультация на a2zsoc.com.

Почему это существует (выручка + затраты)

ИИ-агентные компании не платят за «ещё один MCP». Они платят за то, чтобы остановить несопровождаемые разрушительные инструменты и доказать пробелы Gate/Prove перед SOC 2 Type I, PE-дью-дилидженсом или продлением страховки.

Фактор затрат

Что делает этот гейт

Результат для покупателя

Несопровождаемый shell.exec / отключение контроля / вывод из эксплуатации

DENY, если нет HITL-токена подтверждения + approved

Избежать производственного взрыва

Агент «уверен на 95%»

never_equate_intent_to_approval: true

Намерение ≠ доказательство в журнале

Инструменты записи срабатывают по первому побуждению

По умолчанию SIMULATE (без побочных эффектов)

Минуты FDE, а не стоимость инцидента

Нет журнала аудита

Action Ledger только для добавления с хэш-цепочкой

Пакет для due diligence

Жёсткое правило: никогда не приравнивайте намерение агента или оценку модели к одобрению человеком.

Иллюстративный набросок затрат (не коммерческое предложение): make bench.

Related MCP server: agent-security-gateway

Быстрый старт

make demo
PYTHONPATH=. python3 -m aag demo
PYTHONPATH=. python3 -m aag check fixtures/t1059_unattended_shell.json
PYTHONPATH=. python3 -m aag bench

Несопровождаемые вызовы высокого уровня получают DENY даже при уверенности 0.99. Для ALLOW требуется AAG_PROVE_TOKEN (или --prove-token) и approved: true.

export AAG_PROVE_TOKEN='replace-me'
PYTHONPATH=. python3 -m aag check fixtures/proved_decommission.json --prove-token "$AAG_PROVE_TOKEN"

Аварийный выключатель: AAG_KILL_SWITCH=1 или touch artifacts/KILL.

MCP stdio-сервер

Этот процесс никогда не выполняет инструменты. Клиенты вызывают gate_check перед тем, как вызвать разрушительный инструмент.

PYTHONPATH=. python3 -m aag serve

Пример для Cursor / Claude (mcpServers):

{
  "agent-action-gate": {
    "command": "python3",
    "args": ["-m", "aag", "serve"],
    "cwd": "/path/to/agent-action-gate",
    "env": { "PYTHONPATH": ".", "AAG_PROVE_TOKEN": "replace-me" }
  }
}

Образ Docker / registry:

docker run --rm -i ghcr.io/aah20/agent-action-gate:0.2.0

Официальное имя в MCP Registry: io.github.AAH20/agent-action-gate

Конверт

Каждое решение включает:

  • never_equate_intent_to_approval: true

  • allow_auto_execute (false для несопровождаемых вызовов высокого уровня)

  • mode: deny | simulate | allow

  • ledger_id / receipt_hash

  • CTA: Instant Audit + консультация

Библиотечный маппер

Та же политика Gate/Prove из Python без stdio-цикла:

from aag.gate import AgentActionGate
from aag.mcp import evaluate_mcp_call

gate = AgentActionGate(prove_token="replace-me")
evaluate_mcp_call(gate, {"params": {"name": "shell.exec", "arguments": {"note": "no payload"}}})

Фикстуры (помеченные, не полезные нагрузки)

Файл

Техника

Ожидаемый результат

t1059_unattended_shell.json

T1059

DENY несопровождаемых разрушительных

t1078_read_identity.json

T1078

ALLOW чтения

t1562_impair_defenses.json

T1562

DENY несопровождаемых разрушительных

write_ticket_simulate.json

—

SIMULATE записи

proved_decommission.json

T1578

ALLOW только с HITL-токеном

Структура

aag/
  gate.py      HITL + kill-switch + unknown deny
  ledger.py    hash-chained JSONL
  server.py    MCP stdio (gate_check, ledger_verify)
  mcp.py       MCP tools/call mapper (no execution)
  cost.py      illustrative avoidance sketch
  demo.py      fixture runner
fixtures/      ATT&CK-tagged cases
server.json    MCP Registry metadata
tests/         Gate/Prove + MCP contract

Платная оценка (не бесплатное подтверждение)

Если вы разворачиваете агентов или MCP-серверы и вам нужна оценка Gate/Prove перед SOC 2, PE-дью-дилидженсом или страховкой:

→ $499 Instant Audit
→ консультация (спринт / vCISO)

Бесплатные материалы: отказ — запустите make demo и купите Instant Audit.

Лицензия

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    MCP server that provides human-in-the-loop approval for risky AI agent actions, with durable state and audit logs.
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    MCP server that provides a security gateway for AI agents, enforcing allow/confirm/deny policies on tool calls and requiring human approval for risky operations, with full audit logging.
    -
  • F
    license
    Not graded
    quality
    B
    maintenance
    An MCP server that acts as an authorization gateway between an AI agent and external systems, deterministically refusing actions that exceed granted authority and sealing every decision into an auditable chain of custody.
    -