ShellWard — защита и проверка соответствия для ИИ-агентов
ShellWard
MCP-сервер и CLI проверяют команды, пути, ответы и описания MCP-инструментов, а scan ищет нарушения китайских требований
- 139 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Блокирует и оценивает команды агента, поэтому ошибка правила может остановить рабочий вызов
- Читает файлы проекта и ответы агента, чтобы искать ключи и персональные данные
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/shellwardОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Блокирует и оценивает команды агента, поэтому ошибка правила может остановить рабочий вызов
- Читает файлы проекта и ответы агента, чтобы искать ключи и персональные данные
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ShellWard работает в трех видах. Команда `npx shellward scan` читает проект и ничего не отправляет наружу: ищет ключи в коде, персональные данные в файлах, права на `.env` и вызовы зарубежных моделей, которые в китайском праве считаются выводом данных за границу. Результат приходит оценкой от 0 до 100 с указанием файла и строки. Второй вид, MCP-сервер `shellward-mcp`, дает агенту инструменты проверки. `check_command` оценивает опасность команды оболочки, `check_injection` ищет внедрение подсказок по 37 правилам на китайском и английском, `scan_data` находит персональные данные и ключи, `check_path` смотрит на пути вроде `.ssh` и `.env`, `scan_mcp_tool` ловит спрятанные инструкции в описаниях чужих MCP-инструментов и тихие подмены. Всего 9 инструментов. Третий вид, навык `china-ai-compliance-audit`, поручает агенту полный аудит по 14 контрольным пунктам и сверяет каждый вывод с цитатой из файла. Есть и SDK для встраивания в свои приложения.
Для кого. Командам, которые выпускают ИИ-продукты для китайского рынка, и всем, кто хочет проверять команды и ответы агента перед выполнением.
Подходит, если
- Перед релизом ИИ-приложения в Китае надо найти места, где проект нарушает правила о персональных данных и выводе данных
- В CI хочется падать сборке, если в репозитории найден ключ или критичная находка
- Агент с доступом к оболочке и почте, и надо заблокировать цепочку «прочитал секрет, отправил наружу»
- Подключаете чужой MCP-сервер и хотите проверить его описания на скрытые инструкции
Не подходит, если
- Нужна юридическая оценка: инструмент дает техническую самопроверку
- Проект вне китайского права, и хватит общего сканера секретов: у ShellWard упор на китайские нормы
- Нужна защита уровня операционной системы или песочница: ShellWard проверяет вызовы, но не изолирует процесс
Пример запроса к агенту
Прогони `npx shellward scan` по этому проекту и скажи, какие файлы отправляют персональные данные в зарубежные модели.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
SHELLWARD_MODE- `enforce` блокирует, `audit` только записывает; по умолчанию `enforce`.
SHELLWARD_THRESHOLD- Порог риска от 0 до 100, по умолчанию 40.
Ограничения
Описание и сообщения написаны в первую очередь по-китайски, английская часть README короче. Сканирование показывает только то, что видно в файлах: 11 из 14 контрольных пунктов помечаются как требующие ручной проверки. Заключение юриста инструмент не заменяет. Регистрацию и оценку воздействия на персональные данные организация проходит сама.
Для сборки через GitHub Action есть отдельный режим проверки запросов на слияние. Последний коммит сделан в сентябре 2026 года.
Как отключить. Удалите запись shellward из конфигурации клиента. Команда `scan` ничего не устанавливает и не оставляет службу, достаточно не запускать ее.
Частые вопросы
Как запустить проверку проекта?
Командой `npx shellward scan` в папке проекта. Установка не нужна, данные не отправляются, флаги `--open` и `--serve` показывают отчет в браузере, `--json` и `--ci` подходят для сборки.
Как подключить ShellWard к Claude Desktop или Cursor?
Добавьте в конфигурацию сервер с `"command": "npx"` и `"args": ["-y", "-p", "shellward", "shellward-mcp"]`. После глобальной установки хватает команды `shellward-mcp`.
Блокирует ли он данные или только предупреждает?
Режим задает переменная `SHELLWARD_MODE`: `enforce` по умолчанию блокирует, `audit` только записывает. Данные возвращаются целиком, а отправка наружу блокируется, если недавно читались персональные данные.
Какие агенты поддерживаются?
Claude Desktop, Cursor, Claude Code, OpenClaw, Hermes Agent и любой клиент MCP, для остальных платформ есть SDK через `npm install shellward`.
Заменяет ли ShellWard юриста?
Нет. Это техническая самопроверка: 11 из 14 контрольных пунктов сканирование помечает как требующие ручного подтверждения, а регистрацию и оценку воздействия организация проходит сама.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыСканер безопасности для MCP-серверов: ищет зашитые ключи, отравление инструментов и инъекции в коде репозитория.
Сканер безопасности для агентов: проверяет код, MCP-серверы, промпты и пакеты, выдуманные моделью, и ставит оценку от A до F.
CLI проверки безопасности ИИ: сканирует модели и код, пробует живые эндпоинты и MCP-серверы, разбирает записи работы агентов
Статический сканер уязвимостей в коде ИИ-агентов и конфигурациях MCP с 66 правилами по OWASP Agentic Top 10
MCP проверяет команды оболочки, а хуки shellfirm применяют правила к поддерживаемым вызовам агента до их запуска
AgentShield проверяет папку .claude на ключи в открытом виде, широкие разрешения, опасные хуки и небезопасные MCP-серверы и ставит оценку от A до F
Коротко о README
README открывается 30-секундной проверкой `scan`, затем описывает навык аудита с тремя «воротами» достоверности, MCP-режим, список платформ, восемь слоев защиты и SDK. Есть таблица китайских моделей с OpenAI-совместимыми адресами как замена зарубежным.