kdbx — MCP-сервер для Claude Code: секреты и установка
kdbx даёт агенту доступ на чтение к секретам в локальном хранилище KeePassXC и запускает команды с переменными окружения. Секреты не попадают в историю shell.
claude mcp add --env KEEPASSXC_DIR=<KEEPASSXC_DIR> --env KDBX_ENV=<KDBX_ENV> --transport stdio kdbx -- docker run -i --rm -e KEEPASSXC_DIR -e KDBX_ENV ghcr.io/yarrasys/kdbx:0.3.2Что делает kdbx
kdbx связывает проект с хранилищем KeePassXC через файл .keepassxc.json в репозитории. В файле задаются окружения и соответствия между переменными окружения и записями в хранилище. Сами секреты остаются вне репозитория.
Команда kdbx run -- <cmd> передаёт соответствующие секреты запущенному процессу вместе с текущим окружением. MCP-сервер даёт агенту доступ к секретам только на чтение. Для работы нужны хранилище KeePassXC и ключевой файл; потеря ключевого файла делает хранилище невосстановимым, так что его резервную копию стоит сохранить отдельно.
Какие задачи решает
- передать секреты процессу без файла
.env - запустить тесты с переменными из хранилища KeePassXC
- разделить секреты проекта по окружениям
- дать агенту доступ на чтение к проектным секретам
Примеры запросов агенту
- Запусти тесты проекта с секретами из активного окружения через kdbx.
- Прочитай из хранилища KeePassXC секрет для
OPENAI_API_KEY, не показывая его значение.
Как установить kdbx
Командой платформы
claude mcp add --env KEEPASSXC_DIR=<KEEPASSXC_DIR> --env KDBX_ENV=<KDBX_ENV> --transport stdio kdbx -- docker run -i --rm -e KEEPASSXC_DIR -e KDBX_ENV ghcr.io/yarrasys/kdbx:0.3.2Вместо <…> подставьте свои значения
Командой платформы
codex mcp add kdbx --env KEEPASSXC_DIR=<KEEPASSXC_DIR> --env KDBX_ENV=<KDBX_ENV> -- docker run -i --rm -e KEEPASSXC_DIR -e KDBX_ENV ghcr.io/yarrasys/kdbx:0.3.2Вместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"kdbx": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"KEEPASSXC_DIR",
"-e",
"KDBX_ENV",
"ghcr.io/yarrasys/kdbx:0.3.2"
],
"env": {
"KEEPASSXC_DIR": "<KEEPASSXC_DIR>",
"KDBX_ENV": "<KDBX_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"kdbx": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"KEEPASSXC_DIR",
"-e",
"KDBX_ENV",
"ghcr.io/yarrasys/kdbx:0.3.2"
],
"env": {
"KEEPASSXC_DIR": "<KEEPASSXC_DIR>",
"KDBX_ENV": "<KDBX_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e KEEPASSXC_DIR=<KEEPASSXC_DIR> -e KDBX_ENV=<KDBX_ENV> kdbx docker run -i --rm -e KEEPASSXC_DIR -e KDBX_ENV ghcr.io/yarrasys/kdbx:0.3.2Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о kdbx
Как установить kdbx в Claude Code?
Добавьте сервер командой `claude mcp add --env KEEPASSXC_DIR=<KEEPASSXC_DIR> --env KDBX_ENV=<KDBX_ENV> --transport stdio kdbx -- docker run -i --rm -e KEEPASSXC_DIR -e KDBX_ENV ghcr.io/yarrasys/kdbx:0.3.2`. Укажите пути и окружение вместо плейсхолдеров.
Что делает kdbx?
Сервер открывает агенту доступ на чтение к секретам локального хранилища KeePassXC. Команды запускаются с нужными переменными окружения, а значения секретов не записываются в историю shell.
Что нужно для работы kdbx?
Нужны локальное хранилище KeePassXC, ключевой файл и файл .keepassxc.json с настройками проекта. Ключевой файл следует сохранить: без него хранилище восстановить нельзя.
