mcpField
S
securecode

securecode

本地服务
github.com/juanisidoro安全132 周前更新
代码仓库

关于 securecode

securecode 是供 Claude Code 管理 SecureCodeHQ 密钥的 MCP 服务，默认通过本地文件注入，避免密钥原值出现在聊天中。它还提供访问规则、会话锁定和审计记录。

主要功能

  1. 01将密钥注入本地文件
  2. 02创建、更新、导入和导出密钥
  3. 03应用基于标签的访问规则
  4. 04锁定或解锁指定范围的会话
  5. 05记录密钥访问并执行安全检查

适用场景

  1. 01让 Claude Code 使用 API 密钥而不在聊天中显示原值
  2. 02按标签或活动会话限制密钥访问
  3. 03查看密钥访问记录和会话状态

MCP 相关

Claude Code 通过 stdio 连接本地服务。服务提供密钥管理、会话控制和访问规则查询工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "juanisidoro-securecode": {
      "command": "npx",
      "args": [
        "-y",
        "@securecode/mcp-server"
      ]
    }
  }
}
启动命令npx -y @securecode/mcp-server

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@securecode/mcp-server0.15.2

工具

17

收录的工具列表 · 更新于 2 周前

参数类型必填说明
namestring否机密的准确名称（例如 STRIPE_SECRET_KEY）
tagsobject否用于区分同名机密的标签筛选条件，例如 { "env": "production", "project": "acme" }
revealboolean否如果为 true，则在对话中返回原始值（作为 reveal 进行审计）。默认值：false（注入模式 — 值写入本地文件，绝不显示）
cleanupboolean否如果为 true，则从磁盘删除所有已注入的机密文件

详细介绍

@securecode/mcp-server

适用于 SecureCodeHQ 的 MCP 服务。让 Claude Code 安全地访问你的密钥，而无需查看密钥内容。

SecureCode MCP 服务

快速开始

claude mcp add securecode -- npx -y @securecode/mcp-server

然后告诉 Claude Code：

Set up SecureCode in this project

引导工具会带你完成账户创建、密钥导入和配置。整个过程约需 2 分钟。

功能

你的密钥（API 密钥、令牌、密码）会使用 AES-256 加密并存储在 SecureCode 中。Claude Code 通过 MCP 访问这些密钥，但实际值不会出现在聊天中。

Claude 读取密钥时，密钥值会写入你本机上的本地文件。AI 会获得文件路径，但看不到原始值。这是默认的注入模式。

工具

工具功能
onboard引导式设置：注册、导入、API 密钥、配置、SDK
get-secret获取密钥（默认注入到文件；使用 reveal: true 可向 AI 显示）
list-secrets列出所有密钥及其标签和过期状态
create-secret创建新密钥
update-secret更新值、描述或标签
delete-secret删除密钥
renew-secret续期已过期密钥或更改 TTL
import-env通过安全网页窗口导入 .env（值不会经过 AI）
export-env将密钥导出为 .env 或 CSV
get-status检查方案、用量和 MCP 服务版本
wake-session解锁会话，可选设置作用范围和自动休眠计时器
sleep-session锁定会话并清理注入的文件
session-status检查会话状态和剩余时间
byebye锁定会话并从磁盘清理所有密钥
get-active-rules列出有效的 MCP 访问规则（只读）
security-check检查设置完成后的安全加固情况
help文档：工具、SDK、会话、规则、故障排除

MCP 访问规则

通过基于标签的策略，控制 AI Agent 如何访问你的密钥。规则在仪表板中创建，并由服务端执行。

操作效果
始终阻止只能从仪表板访问密钥
要求确认Agent 必须确认后才能访问
要求会话需要有效会话（wake-session）
屏蔽模型仅允许指定的 AI 模型
通知访问时发送电子邮件（非阻塞）

会话锁定

You: "Wake my session for acme staging"
Claude: Session unlocked. Only acme/staging secrets accessible.

You: "byebye"
Claude: Session locked & secrets cleaned from disk.

会话会在可配置的非活动时间后自动休眠（默认：2 小时）。

工作原理

  • 密钥值会写入本地文件，AI 看不到这些值（注入模式）
  • 明确设置 reveal: true 会将值返回给 AI（会记录审计日志）
  • 休眠、byebye 或进程退出时，会移除注入的文件
  • 多个 Claude Code 实例互不冲突（基于 API 密钥和 PID 生成哈希）
  • 使用 AES-256-GCM 和信封加密进行加密（Cloud KMS）
  • 每次访问都会记录 AI 模型、IP、机器身份和时间戳
  • 通过 stdio 传输在本地运行，密钥不会经过第三方
  • 每台机器首次使用时都需要设备审批

SDK

配套 SDK 可让你的应用在运行时加载密钥：

npm install @securecode/sdk

import { loadEnv } from '@securecode/sdk';
await loadEnv(); // all secrets loaded into process.env

npm 上的 SDK

链接

要求

  • Node.js >= 18
  • SecureCodeHQ 账户（免费套餐：50 个密钥，每月 10K 次访问）

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。