Local Secrets

local-secrets-mcp

Claude Code でローカルのシークレットを管理するためのシンプルな MCP（Model Context Protocol）サーバーです。

API キー、トークン、その他のシークレットをローカルに保存し、Claude Code からアクセスできます。カテゴリーやメモで整理し、.env ファイルをインポート／エクスポートして、CLI または会話で一元管理できます。

クイックスタート

1. データベースを初期化する

npx local-secrets-mcp init

2. シークレットを追加する

npx local-secrets-mcp add OPENAI_API_KEY sk-xxx
npx local-secrets-mcp add ANTHROPIC_API_KEY sk-ant-xxx --category ai
npx local-secrets-mcp add STRIPE_SECRET_KEY sk_live_xxx --category payments

3. Claude Code を設定する

Claude Code の MCP 設定に追加します。

Claude Code CLI の場合（~/.claude.json）：

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

Claude Desktop の場合（macOS では ~/Library/Application Support/Claude/claude_desktop_config.json）：

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

カスタムデータベースの場所（既存のシークレットフォルダーを使用）：

{
  "mcpServers": {
    "local-secrets": {
      "command": "npx",
      "args": ["-y", "local-secrets-mcp", "serve"],
      "env": {
        "SECRETS_PATH": "/path/to/your/.secrets"
      }
    }
  }
}

4. Claude で使用する

設定が完了すると、Claude は次の操作を行えます。

• シークレットの一覧表示：「保存している API キーを教えて」
• シークレットの取得：「OpenAI API キーを取得して」
• シークレットの追加：「この Stripe キーを保存して：sk_live_xxx」
• 検索：「AI 関連のシークレットをすべて探して」

CLI コマンド

# Initialize database
local-secrets-mcp init

# Add a new secret
local-secrets-mcp add <key> <value>
local-secrets-mcp add GITHUB_TOKEN ghp_xxx --category github

# Add or update a secret
local-secrets-mcp set <key> <value>

# Get a secret value
local-secrets-mcp get <key>

# List all secrets
local-secrets-mcp list

# Delete a secret
local-secrets-mcp delete <key>

# Import from .env file
local-secrets-mcp import .env

# Export all secrets as .env format
local-secrets-mcp export > .env

# Show database path
local-secrets-mcp path

# Start MCP server (used by Claude Code)
local-secrets-mcp serve

オプション

• --category, -c - シークレットの追加／更新時にカテゴリーを設定します
• --notes, -n - シークレットにメモを追加します

MCP ツール

Claude Code に接続すると、次のツールを使用できます。

ツール	説明
get_secret	キーを指定してシークレットの値を取得します
list_secrets	すべてのシークレットキーを一覧表示します（カテゴリーでの絞り込みも可能）
search_secrets	キー名のパターンでシークレットを検索します
get_env_value	シークレットを環境変数形式で取得します
add_secret	新しいシークレットを追加します
update_secret	既存のシークレットを更新します
delete_secret	シークレットを削除します

保存先

デフォルトの場所：

• データベース：~/.local-secrets/secrets.db
• アクセスログ：~/.local-secrets/access.log

カスタムの場所： 別のディレクトリを使用するには、SECRETS_PATH 環境変数を設定します。

# CLI
SECRETS_PATH=~/.secrets npx local-secrets-mcp list

# Or export it
export SECRETS_PATH=~/.secrets
npx local-secrets-mcp list

セキュリティに関する注意

• ローカルストレージ：シークレットはお使いのマシン上の SQLite データベースにのみ保存されます
• 会話のコンテキスト：Claude がシークレットを取得すると、その値は会話に含まれ、Anthropic のサーバーに送信されます（チャットにキーを貼り付ける場合と同じです）
• 暗号化なし：ローカルデータベースは暗号化されていません。ファイルシステムの権限に依存します
• アクセスログ：すべてのアクセスは ~/.local-secrets/access.log に記録されます
• 開発用途：これはローカル開発向けに設計されており、本番環境でのシークレット管理向けではありません

シークレットを完全にローカルに保つには： CLI を直接使用します（npx local-secrets-mcp get MY_KEY）。値はターミナルに出力され、ネットワークには一切接続しません。会話での共有に問題のないシークレットを取得する場合にのみ、Claude を使用してください。

要件

• Node.js 22.0.0 以降（必須。Node のネイティブ SQLite モジュールを使用します）
• macOS、Linux、または Windows

ライセンス

MIT