audrey — MCP-сервер для Claude Code: что делает и как установить
Локальная память для кодинг-агентов. Запоминает ошибки прошлых сессий и блокирует опасные команды через хук Guard до их выполнения.
claude mcp add --env AUDREY_DATA_DIR=<AUDREY_DATA_DIR> --env AUDREY_AGENT=<AUDREY_AGENT> --transport stdio audrey -- npx -y audreyЧто делает audrey
Сервер сохраняет контекст работы между запусками агента. Когда сессия только стартует, audrey передаёт компактную сводку с правилами репозитория и недавними рисками. Во время отправки запросов он достаёт нужные факты, а фразы вроде «запомни, что...» превращает в долгосрочные записи.
Главный компонент — Guard. Перед вызовом системных команд или правок файлов он сверяет действие с прошлыми неудачными попытками. Если похожий запуск npm run deploy ранее упал из-за отсутствия артефактов, Guard остановит выполнение и потребует исправить причину. При этом команды чтения вроде grep, git status или cat распознаются автоматически и пропускаются без проверок, чтобы не создавать ложный шум.
Для работы сервера нужен Node.js версии 22.16+ или 24+, так как используется встроенный в платформу SQLite. По умолчанию при сбоях или таймауте в 30 секунд сервер пропускает вызовы дальше, но поведение можно переключить на блокировку через переменную AUDREY_HOOK_FAIL_CLOSED=1.
Какие задачи решает
- остановить повторный запуск упавших деплоев или скриптов
- сохранять правила репозитория между перезапусками сессий
- заблокировать коммит сгенерированных файлов до выполнения команды
- отслеживать последствия вызовов без лишних срабатываний на команды чтения
Примеры запросов агенту
- Запомни, что перед сборкой проекта нужно запустить генерацию типов.
- Проверь статус репозитория и выполни тестовый деплой.
- Не добавляй в коммиты временные конфигурационные файлы.
Как установить audrey
Командой платформы
claude mcp add --env AUDREY_DATA_DIR=<AUDREY_DATA_DIR> --env AUDREY_AGENT=<AUDREY_AGENT> --transport stdio audrey -- npx -y audreyВместо <…> подставьте свои значения
Командой платформы
codex mcp add audrey --env AUDREY_DATA_DIR=<AUDREY_DATA_DIR> --env AUDREY_AGENT=<AUDREY_AGENT> -- npx -y audreyВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"audrey": {
"command": "npx",
"args": [
"-y",
"audrey"
],
"env": {
"AUDREY_DATA_DIR": "<AUDREY_DATA_DIR>",
"AUDREY_AGENT": "<AUDREY_AGENT>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"audrey": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"audrey"
],
"env": {
"AUDREY_DATA_DIR": "<AUDREY_DATA_DIR>",
"AUDREY_AGENT": "<AUDREY_AGENT>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e AUDREY_DATA_DIR=<AUDREY_DATA_DIR> -e AUDREY_AGENT=<AUDREY_AGENT> audrey npx -y audreyВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о audrey
Как установить audrey в Claude Code?
Выполните команду claude mcp add audrey -- npx -y audrey. Если нужно передать переменные окружения, укажите claude mcp add --env AUDREY_DATA_DIR=<AUDREY_DATA_DIR> --env AUDREY_AGENT=<AUDREY_AGENT> --transport stdio audrey -- npx -y audrey.
Зачем нужен хук Guard в audrey?
Хук перехватывает команды до их запуска и сверяет их с прошлыми неудачными попытками. Если действие повторяет недавнюю ошибку, Guard блокирует вызов и выдаёт сохранённые доказательства проблемы.
Какие системные требования нужны для запуска audrey?
Требуется среда Node.js версии 22.16+ или 24+, так как база данных работает на встроенном модуле SQLite. Для локальной проверки без токенов и сети можно выполнить команду audrey demo --scenario repeated-failure.
