VibeDNA Vault

VibeDNA Vault MCP

API キー用の暗号化されたローカル保管庫です。AI は必要に応じてキーを取得し、コードに漏えいがないかスキャンします。

Vault は、すべての API キー、トークン、パスワードを、マシン上の 1 つの暗号化ファイルに保存します（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)	1 つのエントリーの 1 つのフィールドを返します
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（1 つのプロジェクトに適用）に追加します。

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 を参照してください。Copyright (c) 2026 VibeDNA.

サポート：[email protected]