プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

Lockbox

作者:rosostolatoバージョン 0.1.1i★ 2iパソコンで動くリポジトリ ↗
レジストリ名io.github.rosostolato/lockbox-mcp

インストール方法

できること

Let your AI agent set up API keys without ever seeing them.

作者による原文

  • 接続方法 パソコンで動く
  • アカウントまたはキー キー不要
  • カテゴリ その他

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気12/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア24/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: 6 (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Lockbox をインストールして。https://mcp.popnx.com/i/rosostolato-lockbox-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server Lockbox を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "lockbox": { "command": "npx", "args": [ "-y", "lockbox-mcp", "serve" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Lockbox のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  3. この設定を貼り付けて保存

    {
      "mcpServers": {
        "lockbox": {
          "command": "npx",
          "args": [
            "-y",
            "lockbox-mcp",
            "serve"
          ]
        }
      }
    }
  4. Claude を終了してもう一度開く

  5. 試してみる

    Lockbox を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Lockbox を使っていると言うか、回答に Lockbox のツール名が出れば接続成功です

追加の設定 1 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • LOCKBOX_ENV_ALLOWED_ROOTS ファイルの出力先が書き込めるフォルダ。デフォルトは現在のディレクトリです。
    英語の原文を見るFolders that file destinations may write inside. Defaults to the current directory.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Lockbox につなげません

Lockbox はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · Lockbox につなげるアプリを使う

  • 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 先にパソコンへ Node.js を入れてください(1 回だけ)

B · その他 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server Lockbox を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user lockbox -- npx -y lockbox-mcp serve 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Lockbox のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --scope user lockbox -- npx -y lockbox-mcp serve
  4. Claude Code で /mcp と入力

    Lockbox が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    Lockbox を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Lockbox を使っていると言うか、回答に Lockbox のツール名が出れば接続成功です

追加の設定 1 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • LOCKBOX_ENV_ALLOWED_ROOTS ファイルの出力先が書き込めるフォルダ。デフォルトは現在のディレクトリです。
    英語の原文を見るFolders that file destinations may write inside. Defaults to the current directory.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server Lockbox を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "lockbox": { "command": "npx", "args": [ "-y", "lockbox-mcp", "serve" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Lockbox のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. Cursor の AI チャットを Agent モードで開く

  4. 試してみる

    Lockbox を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Lockbox を使っていると言うか、回答に Lockbox のツール名が出れば接続成功です

追加の設定 1 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • LOCKBOX_ENV_ALLOWED_ROOTS ファイルの出力先が書き込めるフォルダ。デフォルトは現在のディレクトリです。
    英語の原文を見るFolders that file destinations may write inside. Defaults to the current directory.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server Lockbox を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "lockbox": { "type": "stdio", "command": "npx", "args": [ "-y", "lockbox-mcp", "serve" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Lockbox のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. VS Code の AI チャットを Agent モードで開く

  4. 試してみる

    Lockbox を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Lockbox を使っていると言うか、回答に Lockbox のツール名が出れば接続成功です

追加の設定 1 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • LOCKBOX_ENV_ALLOWED_ROOTS ファイルの出力先が書き込めるフォルダ。デフォルトは現在のディレクトリです。
    英語の原文を見るFolders that file destinations may write inside. Defaults to the current directory.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?Lockbox を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user lockbox -- npx -y lockbox-mcp serve

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "lockbox": {
      "command": "npx",
      "args": [
        "-y",
        "lockbox-mcp",
        "serve"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "lockbox": {
      "command": "npx",
      "args": [
        "-y",
        "lockbox-mcp",
        "serve"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "lockbox": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "lockbox-mcp",
        "serve"
      ]
    }
  }
}

自分で入力する値

  • LOCKBOX_ENV_ALLOWED_ROOTS env
    ファイルの出力先が書き込めるフォルダ。デフォルトは現在のディレクトリです。
    英語の原文を見るFolders that file destinations may write inside. Defaults to the current directory.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
357/週
接続方法
パソコンで動く
最新バージョンi
0.1.1
カテゴリi
その他
レジストリ公開日i
2026年11月14日
コードの最終更新i
2026年11月14日
作者
rosostolato
パッケージ
npm: lockbox-mcp
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント rosostolato で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:6 日前

  • ✓ 合格

    ライセンスがある

    Apache-2.0を使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に lockbox-mcp@0.1.1 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/rosostolato-lockbox-mcp.svg)](https://mcp.popnx.com/en/servers/rosostolato-lockbox-mcp)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

その他のほかのサーバーとの比較i

  • このカテゴリのほかの20993件のうち91%よりスターが多い
  • このカテゴリのほかの20993件のうち88%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの20993件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Lockboxは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は6 日前、最新バージョン(0.1.1)がレジストリに届いたのは6 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは?

同じカテゴリには:World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

作者:koala73広く使われている★ 9.1万4 日前更新

クラウドで動く✓ 提供元 · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

作者:openstatusHQ広く使われている★ 92762 か月前更新

クラウドで動く✓ 提供元 · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

作者:JanDeDobbeleer広く使われている★ 2.4万 リポジトリ全体のスター31 日前更新

クラウドで動く✓ 提供元 · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

作者:Klavis-AI成長中★ 582314 か月前更新

クラウドで動くリポジトリはアーカイブ済み✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

作者:jitsucom広く使われている★ 51374 か月前更新

クラウドで動く✓ 提供元 · jitsu.com
似たものと比べる
これ
Lockbox
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック3/34/44/44/41/44/4
ライセンスApache-2.0AGPL-3.0AGPL-3.0MITApache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Lockbox

Let your AI agent set up API keys without ever seeing them.

You ask Claude, Cursor or any MCP client to *"put the Stripe key in our .env"* — or in Secret Manager, Vercel, your own API. The agent describes where it goes. You read that in Lockbox's own window and paste the value there. The key goes straight to the destination and never enters the chat, the prompt or the logs.

  1. The agent describes the destination. A file, a program such as gcloud, or an HTTPS request, with {{secret}} where the value goes. The tool has no field that could carry a value.
  2. You check and paste. Lockbox's local window shows where the key goes in one line, warns about anything new or odd, and checks the key's format. The exact request is one click away.
  3. Lockbox sends it. The agent only learns STORED and a reference. It never sees the key.
claude mcp add lockbox -e LOCKBOX_ENV_ALLOWED_ROOTS="$PWD" -- npx -y lockbox-mcp serve

Then ask your agent: *"store my Stripe test key in .env"*.


Install

Lockbox is a stdio MCP server, so you do not run it yourself — your MCP client starts it, the same way it starts any other npm-published server. Requires Node 20+.

Claude Code
cd ~/some/project

claude mcp add lockbox -e LOCKBOX_ENV_ALLOWED_ROOTS="$PWD" -- npx -y lockbox-mcp serve

Add -s project to record it in the repository's .mcp.json instead of your own config.

Any other client (Claude Desktop, Cursor, Windsurf, VS Code, Zed…)

Drop this into the client's MCP configuration — the mcpServers block is the same shape everywhere:

{

"mcpServers": { "lockbox": { "command": "npx", "args": ["-y", "lockbox-mcp", "serve"], "env": { "LOCKBOX_ENV_ALLOWED_ROOTS": "/absolute/path/to/your/project" } } } }

Prefer a pinned install to an ephemeral one:

npm install -g lockbox-mcp

then use lockbox-mcp serve as the command, with no npx

The package is published to npm, unscoped, as lockbox-mcp.

Set `LOCKBOX_ENV_ALLOWED_ROOTS`. File destinations refuse to write outside those directories, and they default only to the server's working directory. Everything else is optional — see Configuration.

Destinations behind a login (Google Secret Manager, Vercel, GitHub) are reached through their own CLI, which uses the login you already have — gcloud, vercel, gh. See Destinations.

First run

Ask your agent for something like *"store my Stripe test key in .env"*. Lockbox opens its window on your machine; the agent does not receive that link. The band at the top tells you the environment at a glance, and the field tells you whether the key looks right before you send it.

Catches the wrong key. A test key headed for production gets flagged in the window. The check runs locally and never shows the value.

Confirms before sending. Nothing is sent until you type where it goes: the host, the program or the file.

Tells the agent only "stored". Lockbox wipes the value and hands back a reference such as the file and variable.

Enter continues and Esc cancels. The link works once: if anything opened it before your browser did, Lockbox shows an alarm and a Cancel button instead of the request. Lockbox's stderr carries structured audit JSON; nothing else is expected of you in the terminal.


What Lockbox solves

It removes an entire class of failures caused by the agent knowing the secret. With Lockbox in the loop, a credential does not pass through:

  • LLM prompts or conversation history
  • MCP tool arguments or tool results
  • agent memory or generated code
  • shell command arguments or process argv
  • logs, debug traces or telemetry
  • URLs
  • model-visible command output

What Lockbox does not solve

Lockbox does not make an AI agent trustworthy, and it is not "safe AI". It does not guarantee that the agent picked the right destination, that it understood you, that it is free of prompt injection, that the destination is itself secure, that your machine is uncompromised, or that a credential cannot be misused later by software that legitimately receives it.

There are two separate problems here:

QuestionLockbox's answer
Should the agent know the secret?No.
Should the agent decide alone where the secret goes?Not without human authorization.

Lockbox answers those two. It does not claim to answer the rest.


Trust model

Trusted with the credential value:

The human at the keyboard Lockbox's secure input UI (loopback only, in your control) Lockbox's secure input broker (this process) The destination you approved (a file, a program, an HTTPS endpoint)

NOT trusted with the credential value:

The LLM The agent / MCP client The conversation The prompt and any repository content it read Generated code Logs, telemetry, crash reports

Lockbox's runtime dependency list is one package (zod, for input validation). The MCP protocol is implemented in-tree rather than through the official SDK, which would add ~90 packages — including HTTP servers and an OAuth stack — to a process that holds plaintext credentials.

This diagram does not claim the trusted components are invulnerable. It says where the credential is *allowed* to exist. Lockbox is security-sensitive software: if Lockbox itself is malicious or compromised, the boundary is gone. Its source, dependencies and releases deserve the scrutiny you would give any credential-handling tool.


The two flows

The secret flow — the human's path, which the model cannot observe:

Human ─▶ Lockbox secure UI (127.0.0.1) ─▶ Broker ─▶ approved definition ─▶ Destination

The agent flow — everything the model sees:

LLM ─▶ MCP client ─▶ Lockbox MCP server ─▶ non-sensitive result metadata

The MCP tool schema has no property capable of carrying a credential. That is structural, not a prompt instruction: there is no value, secret_value, password, token, content or raw_secret field to abuse, closed schemas reject unknown properties, and arguments are screened for credential-shaped values before they are parsed.

What the agent calls
{

"destination": "custom", "name": "STRIPE_SECRET_KEY", "target": { "definition": { "kind": "command", "label": "Google Secret Manager", "executable": "/opt/homebrew/bin/gcloud", "args": ["secrets", "versions", "add", "stripe-secret-key", "--project", "acme-prod", "--data-file=-"], "stdin": "{{secret}}" } }, "environment": "production", "description": "Stripe production API key" }

Lockbox replies with a request_id, a risk classification and the normalized destination — and opens its own authorization window on your machine. The agent polls secret_status. destination: "saved: " reuses a destination the human saved earlier.

The agent does not get the authorization link. That link is a capability: anything holding it can complete the human's half of the flow, and an agent with a shell or an HTTP tool is precisely the threat model. Lockbox hands it straight to your browser. Set LOCKBOX_DISCLOSE_AUTHORIZATION_URL=true if your setup needs the agent to relay the link (for example, a remote or headless session) — and understand that this lets a compromised agent authorize its own request.

The link works once. Opening it trades it for an HttpOnly; SameSite=Lax session cookie scoped to that request and redirects to an address with no token in it; every later page and form needs the cookie. A second opening of the same link gets an alarm page ("This link was already opened") with a Cancel button, never the request. So a copy left in browser history, a process list or a log is dead once you open it, and one used by someone else first is visible to you.

Logs never hold the identity phrase, and hold the link only as a last resort. MCP hosts save server stderr to files any process running as you can read (Claude Desktop under ~/Library/Logs/Claude/, Claude Code under its cache directory), so the audit record carries a short fingerprint of the link instead. The full link is logged only when no browser could be opened (LOCKBOX_OPEN_BROWSER=false, too many windows, or the opener failed), because the operator then has no other way in.

ToolPurpose
secret_storeCreate a credential request. Returns non-sensitive metadata and a request id.
secret_statusPoll a request. Never returns credential material.
secret_cancelCancel a pending request; any entered value is destroyed.
secret_reviseInvalidate an authorization and start a new one. Nothing is edited in place.
secret_destinationsThe definition contract, worked examples, and the user's saved destinations.
What the human sees

Stage A shows the credential name and one destination line — the definition's label and its host, program or file — plus a line for anything worth a second look: a host never used before, a host spelled with non-ASCII characters, an IP address instead of a name, a program outside the system folders, a saved destination that changed. The full request (the URL, every header and the body; or the program, each argument and stdin; or the file and its content) sits behind "See exactly what will be sent", closed by default, with the canonical JSON and its hash. Every custom destination needs a second confirmation in Stage B, after entry and before anything is sent: the human types the host, the program name or the file (.env:API_TOKEN for a variable), and the server checks it. This is an attention check, not authentication: the expected text is on the page. What keeps a second party out of Stage B is the session cookie. The value is never displayed back.

POSTs are refused unless they come from Lockbox's own page (Origin and Sec-Fetch-Site), and every response sets Cross-Origin-Opener-Policy and `Cross-Origin-Reso

冒頭だけを表示しています。続きはリポジトリで読めます