shellfirm MCP
MCP проверяет команды оболочки, а хуки shellfirm применяют правила к поддерживаемым вызовам агента до их запуска
- 953 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Подключение меняет хуки и конфигурацию клиента, влияя на допуск команд
- Политика может заблокировать полезную команду или пропустить опасную
- Инструменты MCP получают текст команды, в котором могут быть секреты
Установка
- Работает в
Ручная установка
npm install -g @shellfirm/cliУстановка программы. Затем подключите свой клиент отдельной командой.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Подключение меняет хуки и конфигурацию клиента, влияя на допуск команд
- Политика может заблокировать полезную команду или пропустить опасную
- Инструменты MCP получают текст команды, в котором могут быть секреты
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
shellfirm дает агенту инструменты для проверки команд оболочки. Через MCP можно передать строку команды и получить совпавшие правила с уровнем опасности. Отдельные инструменты объясняют причину и предлагают альтернативу. Для Claude Code команда `shellfirm connect claude-code` добавляет MCP и хуки. Хуки проверяют поддерживаемые вызовы до выполнения и могут остановить команду, которую правило считает опасной. Обычный вызов MCP сам по себе не перехватывает работу агента. Проверки охватывают типовые ошибки в файловой системе и инструментах разработчика. Вы можете добавить в политику собственные правила. shellfirm анализирует строку и доступные параметры вызова, поэтому произвольное поведение уже запущенной программы остается за пределами такой проверки.
Для кого. Для разработчиков, которые хотят добавить проверку типовых опасных команд к работе кодового агента и терминала.
Подходит, если
- Нужно увидеть, какое правило срабатывает на команду до ее запуска
- Агенту нужно объяснение опасных последствий и вариант менее разрушительной команды
- В Claude Code или Cursor нужно установить автоматические хуки проверок
- Команда хочет добавить собственные правила для чувствительных путей
Не подходит, если
- Нужна изоляция процессов и технический запрет произвольного сетевого доступа
- Нужна гарантия обнаружения всех способов удаления или отправки секретов
- Приложение меняет данные через API, который правила shellfirm не распознают
Пример запроса к агенту
Проверь эту команду через `check_command`, объясни совпавшие правила и предложи альтернативу. Саму команду не запускай.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Для установки через npm нужен Node.js; затем клиент подключают отдельно, иначе одни MCP-вызовы не перехватывают команды. Правила покрывают только распознаваемые строки и параметры, поэтому поведение уже запущенной программы остается вне проверки. Настройка `ignore` отключает выбранную проверку и в оболочке, и у агента, кроме обязательных правил проекта. После обновления с 0.3.10 заново подключите клиента: старые хуки автоматически разрешали команды без находок, новые оставляют решение клиенту.
Как отключить. Выполните `shellfirm connect claude-code --uninstall`, если подключали Claude Code. Для хуков оболочки используйте `shellfirm init --uninstall`, затем перезапустите открытые оболочки. Проверьте `shellfirm status` и удалите пакет своим менеджером. Настройки и журнал сохраняйте или удаляйте отдельно после проверки.
Частые вопросы
Как установить shellfirm через npm?
Выполните `npm install -g @shellfirm/cli`. Для Claude Code затем запустите `shellfirm connect claude-code`. Это отдельный шаг настройки клиента.
Какие инструменты предоставляет MCP?
`check_command` проверяет строку команды, `suggest_alternative` предлагает замену, `explain_risk` объясняет срабатывание. `get_policy` показывает политику. Эти инструменты работают по запросу; автоматический перехват требует хуков.
Можно ли запустить только MCP вручную?
Да. Команда сервера — `shellfirm mcp`. Такой запуск дает инструменты проверки, но не добавляет хуки клиента.
Меняет ли подключение общие настройки Claude Code?
Да, при установке в область пользователя оно записывает хуки в `~/.claude/settings.json` и MCP в `~/.claude.json`. У проекта свои файлы. Сначала проверьте выбранную область.
Заменяет ли shellfirm песочницу?
Нет. Правила не ограничивают права запущенного процесса и не видят все скрытые действия программы. Для изоляции нужна отдельная среда с собственными ограничениями.
Нужен ли отдельный ключ модели?
Нет. shellfirm работает локально, MCP использует stdio без серверного ключа. Код имеет Apache-2.0.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыAgentShield проверяет папку .claude на ключи в открытом виде, широкие разрешения, опасные хуки и небезопасные MCP-серверы и ставит оценку от A до F
Сканер безопасности для агентов: проверяет код, MCP-серверы, промпты и пакеты, выдуманные моделью, и ставит оценку от A до F.
CLI проверяет на вашей машине скиллы и конфиги MCP, ищет отравленные описания инструментов и прогоняет системный промпт через 225 атак
Сканер безопасности для MCP-серверов: ищет зашитые ключи, отравление инструментов и инъекции в коде репозитория.
CLI-посредник проверяет сетевые запросы и вызовы MCP агента: утечки секретов, опасные адреса и внедренные инструкции
MCP-сервер памяти для агентов и бесплатный шлюз, который останавливает опасные команды до запуска
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| shellfirm (эта карточка) | нет | не нужна | 953 | |
| Agent Safehouse | нет | 2 136 | изолирует среду агента; shellfirm проверяет текст команд по правилам до выполнения | |
| Destructive Command Guard | нет | 6 259 | dcg проверяет команды агента перед выполнением, блокирует совпадения с правилами и объясняет, какое действие вызвало запрет. |
Коротко о README
Каталог правил и журнал помогают разобраться, почему команда вызвала предупреждение. Пользовательские проверки добавляют условия для конкретного проекта.