VibeDNA Vault

VibeDNA Vault MCP

用于 API 密钥的本地加密保险库。你的 AI 可按需获取密钥，并扫描代码以查找泄漏。

Vault 会将每个 API 密钥、令牌和密码保存在你设备上的一个加密文件中（使用 Fernet 加密，密钥由你的主密码通过 scrypt 派生）。主密码从系统密钥环读取；没有密钥环的设备则从 VAULT_MASTER_PASSWORD 读取。你的 AI 会在保险库中搜索，并在需要时获取所需的确切密钥，从此不必再把密钥粘贴到聊天中。它可以将条目导出为 .env 行、跟踪轮换日期、保留使用日志、提供常见服务的条目模板，并扫描项目文件夹中以明文遗留的密钥，同时报告文件和行号。

桌面窗口（vault_ui.py）和终端 CLI（vault_core.py）可在不涉及 AI 的情况下打开同一个保险库。无法重置密码：如果丢失主密码，文件将无法读取。

主页：https://vibedna.ai/store/vault

工具（17 个）

工具	功能
credential_exists(name)	在向用户索要密钥前，检查条目是否存在
get_credential(name, key)	返回某个条目的一个字段
list_credentials()	条目名称、类别和字段名称，不包含值
search_credentials(term)	按名称、类别或备注搜索
add_credential(name, category, fields, notes)	添加条目（fields 是一个 JSON 对象）
edit_credential(name, fields)	更新字段；空值会移除该字段
delete_credential(name, confirm)	删除条目（confirm 必须与名称一致）
export_env(name)	将条目的字段导出为 KEY=value 行
add_with_template(service, name, fields, notes)	根据服务模板添加条目
list_templates()	列出可用模板
scan_for_leaks(path)	扫描文件夹中的明文密钥：包括保险库中的值和已知密钥模式
leak_history()	查看近期的泄漏扫描结果
check_rotation_due(days)	列出超过 days 天未轮换的条目
mark_rotated(name)	记录一次轮换
usage_log(name)	查看近期的凭据访问事件
backup_vault()	将加密文件复制到备份文件夹
check_for_update()	将此副本与已发布版本进行比较

安装

git clone https://github.com/marstudio360/vibedna-vault-mcp
cd vibedna-vault-mcp
python -m venv .venv
# Windows: .venv\Scripts\activate    mac/linux: source .venv/bin/activate
pip install -r requirements.txt
python vault_core.py init

在系统密钥环中保存一次主密码，以便 MCP 服务可以打开保险库：

python -c "import keyring; keyring.set_password('vibedna-vault','master', input('master password: '))"

Claude Code

claude mcp add vault --scope user -- /absolute/path/to/vibedna-vault-mcp/.venv/bin/python /absolute/path/to/vibedna-vault-mcp/server.py

也可以在项目的 .mcp.json 中配置：

{
  "mcpServers": {
    "vault": {
      "command": "/absolute/path/to/vibedna-vault-mcp/.venv/bin/python",
      "args": ["/absolute/path/to/vibedna-vault-mcp/server.py"]
    }
  }
}

在 Windows 上，解释器路径为 .venv\Scripts\python.exe。

Cursor

将相同的 mcpServers 配置块添加到 ~/.cursor/mcp.json（适用于所有项目）或 .cursor/mcp.json（适用于单个项目）。

Claude Desktop

将相同的 mcpServers 配置块添加到 claude_desktop_config.json（Settings > Developer > Edit Config），然后重启 Claude Desktop。

INSTALL.md 是一份分步指南，专为粘贴到 AI 聊天中并让 AI 执行安装而编写。指南也介绍了桌面窗口和 CLI。

配置

变量	默认值	功能
VAULT_HOME	~/.vibedna-vault	加密保险库文件（vault.enc）所在的文件夹
VAULT_MASTER_PASSWORD	（未设置）	用于没有系统密钥环的设备的主密码
VAULT_BACKUP_HOME	~/.vibedna-vault/backups	backup_vault 存放副本的位置（保留最近 30 份）

使用日志和泄漏扫描结果会写入保险库文件旁的 logs/ 文件夹中。

网络

保险库、窗口和 CLI 都不会发出网络请求。唯一会发出网络请求的工具是 check_for_update：它会从 https://vibedna.ai/api/mcp/latest 获取已发布的版本号。

许可证

MIT，详见 LICENSE。版权所有 (c) 2026 VibeDNA。

支持邮箱：[email protected]