
KeePassBox
io.github.psyb0t由 GitHub 账号 psyb0t 发布v0.1.1更新于 Nov 22, 2026
Manage KeePass vaults, entries, and TOTP over MCP.
概览
KeePassBox 在本机以 REST 和 MCP 接口暴露 KeePass 密码库,让助手管理密码库、条目和 TOTP 验证码。
- 可以做什么
- 创建、解锁并配置密码库,包括加密算法、KDF、Argon2 内存、迭代次数和压缩方式
- 轮换密码库的主密码或密钥文件
- 创建分组、搜索条目、移动或移入回收站,并编辑密码、备注、标签、受保护字段和小型附件
- 在条目中保存 TOTP 种子或 URI,并返回当前验证码和过期时间
- 签发仅限某个所有者密码库的 bearer 令牌,并可自定义权限范围
- 适用场景
- 适合让助手查询或更新你已有的 KeePass 密码库中的凭据和 TOTP 验证码,或在不脱离 KeePass 格式的前提下自动完成密码轮换、KDF 参数调整等维护工作。
- 运行要求
- 以本机 Docker 容器运行(安装脚本需要 Docker Compose、curl 和 OpenSSL),在 Linux 上以普通 Docker 用户启动。MCP 通过本机端口的 Streamable HTTP 提供,需要安装器生成的 bearer 令牌。密码库默认存放在用户配置目录下。
安装
在 SourceWeft 中
- 打开 控制台中的 KeePassBox,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
KeePassBox
[CI] [version] [license] [Docker Pulls]
Put KeePass behind REST and MCP. Create a vault, rotate its master password, turn Argon2 up to 512 MiB, or grab a TOTP code from the terminal. You can open the same .kdbx in KeePassXC.
Contents
Quick start
Run this as your regular Docker user on Linux. You need Docker Compose, curl, and OpenSSL.
If your shell can't find the command, run ~/.local/bin/keepassbox start. Run keepassbox token to get the installer-generated bearer token. It can manage its owner's vaults, read passwords, and generate TOTP codes. REST is at http://localhost:8000/v1, and MCP is at http://localhost:8000/mcp.
The installer puts the Compose files and vaults in ~/.config/keepassbox/ by default and uses the published psyb0t/keepassbox:latest image. See the install guide to pin a version, change the port, or upgrade.
What it does
- Create and unlock multiple vaults with a master password, a configured key file, or both.
- Change the KDBX 4 cipher, KDF, Argon2 memory, iterations, parallelism, and compression. Rotate the password or key file separately.
- Create groups, search entries, move or trash them, and edit passwords, notes, tags, protected fields, and small attachments.
- Save a TOTP seed or URI inside an entry and return the current code and expiry.
- Give each bearer token access to one owner's vaults. Restrict individual tokens with a custom scope list.
Ordinary edits preserve entry history. The API reference lists the supported operations and file formats.
Agent integrations
Connect a Streamable HTTP MCP client to http://localhost:8000/mcp and configure its bearer token. See MCP configuration.
Configure KEEPASSBOX_URL and KEEPASSBOX_TOKEN for the OpenClaw bridge.
Documentation
Read the KeePassBox docs for install options, vault security settings, and the REST and MCP commands.
Development
The tests run in Docker with synthetic KDBX files. The engine tests check encrypted round trips and TOTP. Integration tests call both transports.
Sponsor
License
来源:README.md,提交 59fa70d
工具
0版本历史
1- v0.1.1最新Nov 22, 2026
评分
已满足适用检查项的 50%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分