Agent Audit CLI
Статический сканер уязвимостей в коде ИИ-агентов и конфигурациях MCP с 66 правилами по OWASP Agentic Top 10
- 245 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сканер читает исходники, файлы конфигурации и найденные секреты в проекте, но сам ничего не меняет
- Команда `inspect` запускает указанный MCP-сервер как процесс, поэтому ее применяют только к доверенным серверам
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/agent-auditОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сканер читает исходники, файлы конфигурации и найденные секреты в проекте, но сам ничего не меняет
- Команда `inspect` запускает указанный MCP-сервер как процесс, поэтому ее применяют только к доверенным серверам
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Agent Audit проверяет проект с агентом до выкатки: `agent-audit scan ./project` разбирает Python-код, JSON и YAML-конфигурации, файлы с секретами и выдает отчет с итоговой оценкой от 0 до 10. Правила охватывают внедрение в промпт, опасные вызовы `subprocess` и `eval` из функций-инструментов, утечки ключей в коде и конфигурации MCP, серверы без аутентификации, подмену инструментов и отравление их описаний, а также автоодобрение всех инструментов. Движок прослеживает путь данных от параметров функции `@tool` до опасного вызова, ищет секреты в три этапа и разбирает файлы вроде `claude_desktop_config.json` и `.mcp.json`. Команда `agent-audit inspect stdio -- npx -y ...` подключается к живому MCP-серверу и читает его описание инструментов, не вызывая их. Для LangChain, CrewAI, AutoGen и AgentScope есть отдельные проверки. В CI используйте `--fail-on high`: код выхода 1 появляется, когда найдены находки этого уровня и выше. Форматы вывода: терминал, JSON, SARIF для GitHub Code Scanning и Markdown. Через `--save-baseline` и `--baseline` отслеживаются только новые находки.
Для кого. Командам, которые выпускают агентов на LangChain, CrewAI или AutoGen и серверы MCP, и хотят остановить уязвимость до слияния в основную ветку.
Подходит, если
- Запрос на слияние добавляет функцию-инструмент, которая передает строку пользователя в `subprocess.run` с `shell=True`
- В `claude_desktop_config.json` у MCP-сервера прописан ключ API открытым текстом и нет закрепленной версии пакета
- Перед установкой чужого MCP-сервера надо понять, нет ли в описаниях инструментов скрытых инструкций
- В CI нужен барьер по уровню серьезности и отчет SARIF во вкладке Security репозитория
Не подходит, если
- Нужен анализ поведения агента во время работы: сканер читает код и конфигурации и не проверяет живые диалоги
- Проект на языке, где нет Python и конфигураций MCP: основной разбор кода идет по Python
- Находки нужны без ручной сортировки: по оценке автора часть срабатываний ложная
Пример запроса к агенту
Запусти `agent-audit scan . --severity high` в корне проекта и разбери находки, начиная с внедрения команд в функциях-инструментахОграничения
- Основной разбор кода рассчитан на Python, остальное покрывают проверки конфигураций, JSON, YAML и секретов.
- На собственном наборе автора из 81 примера точность 68,86 процента, полнота 84,32 процента, поэтому находки требуют ручного разбора.
- Команда `inspect` запускает указанный MCP-сервер и читает его инструменты, не вызывая их, так что запускайте только серверы, которым доверяете.
- Последний коммит сделан в сентябре 2026. Описание репозитория называет 51 правило, README считает 66.
Как отключить. Удалите пакет командой `pip uninstall agent-audit`. Если подключали GitHub Action `HeadyZhang/agent-audit@v1`, уберите шаг из файла рабочего процесса.
Частые вопросы
Чем отличаются --severity и --fail-on?
`--severity` задает, какие находки попадут в отчет, а `--fail-on` задает уровень, при котором команда завершится с кодом 1. Для CI обычно ставят `--fail-on high`.
Как получить отчет для вкладки Security в GitHub?
Выполните `agent-audit scan . --format sarif --output results.sarif` или подключите GitHub Action `HeadyZhang/agent-audit@v1`, где `upload-sarif` включен по умолчанию.
Есть ли версия как скилл для OpenClaw?
Да, на ClawHub лежит `agent-audit-scanner`, ставится командой `npx clawhub@latest install agent-audit-scanner`. Он проверяет установленные скиллы и конфигурацию OpenClaw.
Как не разбирать старые находки при каждом запуске?
Сохраните текущее состояние через `--save-baseline baseline.json`, затем запускайте с `--baseline baseline.json --fail-on-new`. Тогда в отчет попадут только новые находки.
Как читать оценку в отчете?
Отчет делит находки на BLOCK, WARN и INFO, а BLOCK Tier 1 включает находки с достоверностью от 90 процентов. Итоговая оценка идет по шкале 0–10 с меткой, например 8.4/10 (HIGH).
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСканер безопасности для агентов: проверяет код, MCP-серверы, промпты и пакеты, выдуманные моделью, и ставит оценку от A до F.
Сканер ищет в конфигах MCP у Claude Desktop, Cursor и VS Code утекшие ключи, опасные доступы и подключенные модели.
CLI проверяет на вашей машине скиллы и конфиги MCP, ищет отравленные описания инструментов и прогоняет системный промпт через 225 атак
CLI проверки безопасности ИИ: сканирует модели и код, пробует живые эндпоинты и MCP-серверы, разбирает записи работы агентов
AgentShield проверяет папку .claude на ключи в открытом виде, широкие разрешения, опасные хуки и небезопасные MCP-серверы и ставит оценку от A до F
Agentic Radar разбирает код многоагентных систем на LangGraph, CrewAI, n8n, OpenAI Agents и AutoGen и собирает HTML-отчет об инструментах и уязвимостях
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Agent Audit (эта карточка) | нет | 245 | |
| Snyk Agent Scan | нет | 3 208 | CLI от Snyk ищет на машине установленные MCP-серверы и скиллы; здесь сканируется код проекта агента и его конфигурации |
| MCP Scanner | да | 1 107 | сканер Cisco проверяет MCP-серверы тремя движками; здесь статический разбор кода агента с отслеживанием данных и правилами OWASP |
Коротко о README
README объясняет, чем опасны агенты в продакшене и показывает установку и первый запуск в несколько команд. Дальше идут пример отчета, снимок метрик на собственном наборе, таблица категорий находок, поддержка OpenClaw, примеры использования, базовые линии и GitHub Action. В конце сравнение с Bandit и Semgrep, архитектура и таблица охвата OWASP.