Pipelock CLI
CLI-посредник проверяет сетевые запросы и вызовы MCP агента: утечки секретов, опасные адреса и внедренные инструкции
- 984 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Посредник получает запросы и ответы инструментов, в которых бывают секреты
- Отдельные режимы меняют сетевые ограничения и настройки доверия сертификатам
Установка
- Работает в
Ручная установка
git clone --branch v3.7.0 --depth 1 https://github.com/pipelab-org/pipelock.git
make -C pipelock installПервый командный маршрут quick start README: сборка Community v3.7.0, нужен Go 1.26 или новее. Перед установкой изучите исходники; команды мы не запускали.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Посредник получает запросы и ответы инструментов, в которых бывают секреты
- Отдельные режимы меняют сетевые ограничения и настройки доверия сертификатам
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Pipelock проверяет трафик агента, который проходит через его прокси. Программа сопоставляет адреса и содержимое запросов с выбранной политикой. По результату она пропускает обращение, блокирует его или меняет найденные чувствительные фрагменты. В режиме MCP Pipelock запускает локальный сервер либо соединяет клиента с удаленным. Он проверяет аргументы и ответы инструментов, а в их описаниях ищет скрытые инструкции. Для HTTP работает отдельный прокси; чтение HTTPS-содержимого требует настройки перехвата TLS. Pipelock сохраняет решения в журнале и поддерживает подписанные записи действий. По подписи можно проверить происхождение записи, но нельзя подтвердить правильность решения сканера. Команды диагностики помогают проверить настройки и то, действительно ли клиент направляет трафик через прокси.
Для кого. Для разработчиков и инженеров безопасности, которым нужно контролировать сетевые обращения и MCP-инструменты работающего агента.
Подходит, если
- Нужно проверять аргументы и ответы выбранного MCP-сервера до передачи следующей стороне
- Внешние обращения агента требуется пропускать по ограниченному списку адресов
- Для разбора инцидента нужны записи решений с проверяемыми подписями
- Нужно проверить, действительно ли выбранный клиент использует настроенный сетевой посредник
Не подходит, если
- Вы ожидаете, что одно указание прокси закроет все прямые сетевые соединения любой программы
- Нужна безошибочная оценка каждой инструкции или полная защита от утечки данных
- Нельзя настраивать доверие к сертификату, а требуется проверка содержимого произвольного HTTPS-трафика
Пример запроса к агенту
Подготовь Pipelock для одного тестового MCP-сервера. Сначала покажи конфигурацию и границы проверки, затем проверь один безопасный запрос. Системные сетевые ограничения без согласования не устанавливай.Ограничения
Команда `pipelock exec` задает прокси через окружение, но клиент может его проигнорировать; принудительное ограничение сети требует отдельных средств ОС. Проверка готовности перед запуском клиента не означает наблюдение за состоянием прокси всю сессию. Для расшифровки TLS нужны центр сертификации и доверие клиентов, а исключенные домены остаются без проверки содержимого. Сборка Community требует Go 1.26 и не содержит обычного механизма обновления подписанных релизов: ее нужно пересобирать отдельно.
Как отключить. Остановите прокси и восстановите прежнее подключение клиента. Если настраивали ограничения ОС, используйте отдельную процедуру отката этого режима. Удаление бинарника не отменяет настройки сертификатов и сети и не очищает журналы.
Частые вопросы
Как обернуть локальный MCP-сервер?
Используйте `pipelock mcp proxy --config pipelock.yaml -- <команда сервера>`. После разделителя указывается реальная команда выбранного сервера. Pipelock запускает его и проверяет проходящие сообщения.
Можно ли подключить удаленный MCP по HTTP?
Да. Например, `pipelock mcp proxy --upstream http://localhost:8080/mcp` связывает клиента по stdio с указанным сервером. Замените пример адресом своей тестовой установки.
Как запустить Claude Code через работающий прокси?
Сначала запустите прокси командой `pipelock run --config pipelock.yaml`. В другом терминале выполните `pipelock exec --config pipelock.yaml -- claude`. Команда проверит службу и передаст настройки клиенту; затем проверьте, использует ли он этот сетевой маршрут.
В режиме `audit` все действия только записываются?
Нет. Обычные нарушения политики дают предупреждения, но базовые проверки адресов могут блокировать обращения. Выбирайте режим по описанию его проверок, прежде чем применять к рабочему агенту.
Что остается бесплатным?
Основные сканеры, отдельные режимы ограничения, проверка подписей и просмотр записей одной сессии. Именованные профили агентов, операторская панель и управление парком относятся к отдельным редакциям.
Какая лицензия у разных редакций?
Базовое ядро имеет Apache-2.0. Возможности Pro и Enterprise используют ELv2 и требуют лицензионный ключ.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер поверх mitmproxy: агент читает HTTP-трафик, подменяет ответы, повторяет запросы и собирает спецификацию API.
Сканер безопасности для MCP-серверов: ищет зашитые ключи, отравление инструментов и инъекции в коде репозитория.
Шлюз для MCP-серверов: плагины маскировки известных секретов в текстовых ответах, проверки репутации и записи вызовов
70 инструментов для прокси Caido: история запросов, повтор, фаззинг и находки доступны агенту при авторизованном тестировании.
Сканер ищет в конфигах MCP у Claude Desktop, Cursor и VS Code утекшие ключи, опасные доступы и подключенные модели.
MCP проверяет команды оболочки, а хуки shellfirm применяют правила к поддерживаемым вызовам агента до их запуска
Коротко о README
Примеры установки привязаны к выпуску 3.7.0. Готовые релизы включают ключи проверки обновлений и код дополнительных редакций, который активируется лицензией.