KeePassBox

io.github.psyb0t由 GitHub 帳號 psyb0t 發布v0.1.1更新於 Nov 22, 2026

Manage KeePass vaults, entries, and TOTP over MCP.

已驗證STDIO僅桌面檔案與儲存安全與監控

概覽

AI 產生的概覽

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 權杖。密碼庫預設存放在使用者的設定目錄下。
安裝前請注意
此服務持有主密碼、金鑰檔與 TOTP 種子,其 bearer 權杖可讀取密碼並產生所屬密碼庫的 TOTP 驗證碼,應視為高價值機密並盡量縮小權限範圍。編輯、移動、移到資源回收筒以及輪替密碼或金鑰檔都會變更密碼庫資料,操作前請先備份。安裝腳本會下載並執行遠端腳本,並拉取已發佈的映像檔。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 KeePassBox,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

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.

sh
curl -fsSL https://raw.githubusercontent.com/psyb0t/docker-keepassbox/main/install.sh | bashkeepassbox start

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.

sh
openclaw skills install @psyb0t/docker-keepassboxopenclaw plugins install clawhub:@psyb0t/keepassbox

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

sh
make lintmake testmake secmake build

The tests run in Docker with synthetic KDBX files. The engine tests check encrypted round trips and TOTP. Integration tests call both transports.

Sponsor

Sponsor on GitHub

[Buy Me a Coffee]

License

GPL-3.0. The vault engine uses PyKeePass.

來源:README.md,提交 59fa70d

工具

0
SourceWeft 曾在隔離沙箱中以無憑證方式啟動該軟體包一次,以列出其工具,但未能完成:該軟體包類型無法在沙箱中執行。

版本歷史

1
  1. v0.1.1最新Nov 22, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分