Keyfold

Keyfold 核心

Keyfold 的开源部分。这是一款离线优先的开发者保险库：在一个加密文件中按项目和环境整理 API 密钥，并存储密码。无需账户、云服务或遥测。

Mac 版 Keyfold 应用基于这些 crate 构建（Windows 版将通过 Microsoft Store 推出）。前往 keyfold.app/download 获取；签名版本也可在 Releases 页面下载。

内容

Crate	功能
crates/keyfold-core	Argon2id 密钥派生、XChaCha20-Poly1305 信封加密、防篡改保险库格式、滚动备份、Recovery Kit、.env 解析、密钥检测模式、双重身份验证代码（RFC 6238）以及离线 Ed25519 许可证验证
crates/keyfold-agent	keyfold CLI 与运行中应用之间的 JSON 行协议，通过仅所有者可访问的本地套接字通信
crates/keyfold-cli	keyfold 命令行工具，以及供 Cursor 和 Claude Code 使用的 MCP 服务。任何工具都不会返回密钥值；每个请求都必须在应用中获批

将其与 AI Agent 配合使用（MCP）

keyfold mcp 可让 Claude Code、Cursor、Codex、Gemini CLI 和其他 MCP 客户端使用你的 API 密钥，同时不让模型看到密钥。其七种工具可列出项目和密钥名称、写入经你批准的 .env 文件、注入密钥运行命令、存储密钥、创建项目，以及导入 .env 文件。它们都不会返回密钥值。每个请求都需要等待你在 Keyfold 应用中点击批准；应用会显示密钥将用于哪个命令或文件。

1. 安装 Keyfold for Mac。在应用中打开「设置 › 通用 › 命令行和 MCP」，然后点击「安装」，将 keyfold 添加到你的 PATH。
2. 将服务添加到你的客户端：

claude mcp add --scope user keyfold -- keyfold mcp

Cursor（.cursor/mcp.json）：{ "mcpServers": { "keyfold": { "command": "keyfold", "args": ["mcp"] } } }

你批准的命令仍可能打印密钥，而模型可以读取打印的内容；MCP 指南介绍了这一点以及一小时批准机制。服务要求 Keyfold 应用在同一台 Mac 上运行并处于解锁状态。该 Dockerfile 仅在 Linux 上构建，以便 MCP 目录读取其工具列表。

MCP Registry 名称：mcp-name: io.github.codewithkolin/keyfold

文档

• 保险库格式：文件中的每个字节，以及如何对其进行身份验证。
• 威胁模型：Keyfold 能防范哪些威胁，以及无法防范哪些威胁。
• MCP 和 CLI 指南：如何连接 AI Agent，而不向其展示你的密钥。

构建和测试

cargo test --workspace
cargo clippy --workspace --all-targets -- -D warnings
cargo build --release -p keyfold-cli   # the `keyfold` binary

使用 Rust stable，无需其他工具链。

安全

请私下报告安全漏洞；详见 SECURITY.md。

许可证

AGPL-3.0-only。请参阅各 crate 中的 LICENSE 文件。基于这些 crate 构建的 Keyfold 桌面应用为专有软件。