Local Secrets

local-secrets-mcp

一个简单的 MCP（Model Context Protocol）服务，用于通过 Claude Code 管理本地机密。

在本地存储 API 密钥、令牌和其他机密，并通过 Claude Code 访问。按类别和备注整理机密，导入/导出 .env 文件，并通过命令行或对话管理所有内容。

快速开始

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 相关的机密”

命令行命令

# 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
• 用于开发：此工具专为本地开发设计，不适用于生产环境的机密管理

**确保机密完全留在本地：**直接使用命令行（npx local-secrets-mcp get MY_KEY）——这会将机密打印到终端，不会访问网络。只有在你愿意让机密出现在对话中时，才使用 Claude 获取机密。

要求

• Node.js 22.0.0 或更高版本（必需——使用 Node 原生 SQLite 模块）
• macOS、Linux 或 Windows

许可证

MIT