Aletheia Safety Filter — MCP-сервер для Claude Code: установка
Перехватывает и отсекает опасные системные вызовы агента за доли миллисекунды. Защищает рабочие папки, переменные окружения и базы данных от несанкционированных изменений.
claude mcp add --env ALETHEIA_ALLOW_WRITE=<ALETHEIA_ALLOW_WRITE> --env ALETHEIA_ALLOW_NETWORK=<ALETHEIA_ALLOW_NETWORK> --env ALETHEIA_ALLOW_LOOPBACK=<ALETHEIA_ALLOW_LOOPBACK> --env ALETHEIA_OPERATOR_SECRET=<ALETHEIA_OPERATOR_SECRET> --transport stdio aletheia-runtime-safety-scope-creep-filter -- npx -y aletheia-mcpЧто делает Aletheia Runtime Safety & Scope Creep Filter
Детерминированный лексический фильтр проверяет команды терминала, запросы SQL и сетевые обращения до того, как агент начнёт их выполнять. В отличие от тяжеловесных проверок через вторую нейросеть, сервер тратит около 25 микросекунд на анализ вызова и не обращается к внешним LLM. Правила ловят попытки стереть дерево файлов, сбросить git-индекс через жёсткий сброс, прочитать чужой приватный ключ ~/.ssh/id_rsa или выгрузить данные из таблиц без условия WHERE.
Внутри зашиты эвристические шаблоны против расширения границ задачи и внедрения скрытых команд из текстов файлов. Этот инструмент не заменяет полноценную изоляцию операционной системы: строчный анализатор Bash и SQL пропустит нестандартную обфускацию и сетевые запросы к доменам, поскольку он не резолвит DNS. Фильтр снижает число глупых сбоев, но реальную безопасность обеспечивает только запуск внутри контейнеров вроде Docker или Firecracker.
Для работы требуется среда Node.js и утилита npx. При регистрации передаются флаги разрешений на сеть и запись файлов, а также переменная ALETHEIA_OPERATOR_SECRET. Без операторского секрета защитный шлюз не запустится.
Какие задачи решает
- блокировать удаление файлов и жёсткий сброс состояния git
- пресекать чтение приватных ключей и переменных окружения
- останавливать опасные SQL-запросы без фильтрации по условию
- перехватывать обращения к метаданным облака по адресу
169.254.169.254
Примеры запросов агенту
- Запусти аудит репозитория, но не трогай скрытые конфигурационные файлы.
- Обнови статус записей в таблице базы данных с обязательным фильтром по идентификаторам.
- Собери сетевую статистику без отправки запросов к внутренним подсетям компании.
Как установить Aletheia Runtime Safety & Scope Creep Filter
Командой платформы
claude mcp add --env ALETHEIA_ALLOW_WRITE=<ALETHEIA_ALLOW_WRITE> --env ALETHEIA_ALLOW_NETWORK=<ALETHEIA_ALLOW_NETWORK> --env ALETHEIA_ALLOW_LOOPBACK=<ALETHEIA_ALLOW_LOOPBACK> --env ALETHEIA_OPERATOR_SECRET=<ALETHEIA_OPERATOR_SECRET> --transport stdio aletheia-runtime-safety-scope-creep-filter -- npx -y aletheia-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add aletheia-runtime-safety-scope-creep-filter --env ALETHEIA_ALLOW_WRITE=<ALETHEIA_ALLOW_WRITE> --env ALETHEIA_ALLOW_NETWORK=<ALETHEIA_ALLOW_NETWORK> --env ALETHEIA_ALLOW_LOOPBACK=<ALETHEIA_ALLOW_LOOPBACK> --env ALETHEIA_OPERATOR_SECRET=<ALETHEIA_OPERATOR_SECRET> -- npx -y aletheia-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"aletheia-runtime-safety-scope-creep-filter": {
"command": "npx",
"args": [
"-y",
"aletheia-mcp"
],
"env": {
"ALETHEIA_ALLOW_WRITE": "<ALETHEIA_ALLOW_WRITE>",
"ALETHEIA_ALLOW_NETWORK": "<ALETHEIA_ALLOW_NETWORK>",
"ALETHEIA_ALLOW_LOOPBACK": "<ALETHEIA_ALLOW_LOOPBACK>",
"ALETHEIA_OPERATOR_SECRET": "<ALETHEIA_OPERATOR_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"aletheia-runtime-safety-scope-creep-filter": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"aletheia-mcp"
],
"env": {
"ALETHEIA_ALLOW_WRITE": "<ALETHEIA_ALLOW_WRITE>",
"ALETHEIA_ALLOW_NETWORK": "<ALETHEIA_ALLOW_NETWORK>",
"ALETHEIA_ALLOW_LOOPBACK": "<ALETHEIA_ALLOW_LOOPBACK>",
"ALETHEIA_OPERATOR_SECRET": "<ALETHEIA_OPERATOR_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e ALETHEIA_ALLOW_WRITE=<ALETHEIA_ALLOW_WRITE> -e ALETHEIA_ALLOW_NETWORK=<ALETHEIA_ALLOW_NETWORK> -e ALETHEIA_ALLOW_LOOPBACK=<ALETHEIA_ALLOW_LOOPBACK> -e ALETHEIA_OPERATOR_SECRET=<ALETHEIA_OPERATOR_SECRET> aletheia-runtime-safety-scope-creep-filter npx -y aletheia-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Aletheia Runtime Safety & Scope Creep Filter
Как установить Aletheia Runtime Safety & Scope Creep Filter в Claude Code?
Выполните команду claude mcp add aletheia-mcp -e ALETHEIA_OPERATOR_SECRET=<ALETHEIA_OPERATOR_SECRET> -- npx -y aletheia-mcp. При необходимости добавьте переменные доступа ALETHEIA_ALLOW_WRITE и ALETHEIA_ALLOW_NETWORK.
Что проверяет Aletheia в процессе работы?
Сервер анализирует вызовы Bash, SQL и сетевые запросы на признаки выхода за пределы выданной задачи, попытки прочитать чужие секреты или разрушить репозиторий. Анализ занимает микросекунды без отправки данных в LLM.
Заменяет ли этот фильтр запуск в контейнере?
Нет, фильтрация опирается на эвристический поиск известных опасных текстовых паттернов и не изолирует окружение. Сложная обфускация команд и DNS-перенаправления требуют ограничений на уровне ядра ОС.
