用途
AI 智能体在运行时经常需要敏感信息——API 密钥、密码、凭据。目前用户通常直接将这些信息粘贴到聊天中,从而被永久保存在对话历史里。Volta MCP 服务器通过阅后即焚的加密笔记解决这一问题:用户可在 voltanotes.com 创建笔记并发送一次性 URL,智能体调用 read_volta_note 读取后笔记即被永久销毁,敏感信息不再出现在聊天历史中;反向亦可,智能体可用 create_volta_note 通过自毁链接向用户发送凭据。
主要能力
- create_volta_note:创建加密笔记并返回一次性 URL。接收者只能打开一次,阅读后内容永久消失。
- read_volta_note:读取并永久销毁 Volta 笔记。返回解密后的内容;笔记会从 canister 中永久删除,再次读取将失败。
- 笔记采用 AES-256-GCM 端到端加密,加密在发送到 canister 之前于本地完成。
- 解密密钥仅存在于 URL 片段(#...)中,浏览器和服务器从不传输片段。
- ICP canister 仅存储密文,即使被攻破所有数据也无法读取。
- 笔记首次读取即销毁,未读取的笔记在 7 天后过期。
- 无需账户、无需登录、无追踪。
使用方式
Claude Code(CLI 与桌面应用)
第 1 步——全局安装。
第 2 步——注册服务器。
完成后重启 Claude Code,create_volta_note 和 read_volta_note 工具即可使用。
说明:为何使用 claude mcp add 而非编辑配置文件?Claude Code 从其自身注册表读取 MCP 服务器,而不是 ~/.claude/mcp.json。使用 CLI 可确保服务器正确注册。-s user 标志使其在所有项目中可用。
找不到 node?使用完整路径:将 node 替换为 which node 的输出(例如 /usr/local/bin/node)。
Claude Desktop(独立版)
添加到 claude_desktop_config.json 中。
其他兼容 MCP 的客户端
上述 npx 配置适用于任何支持标准 command / args MCP 格式的客户端——包括 Cursor、Windsurf、Cline、Continue.dev 等。请在客户端的 MCP 文档中查找添加服务器配置的位置。
Hermes Agent(Nous Research)
Volta MCP 通过 Hermes 的 MCP 集成与之配合。将服务器添加到 Hermes 配置(~/.hermes/config.yaml)中,重启 Hermes 后智能体即可使用 create_volta_note 和 read_volta_note 工具。
智能体间用例:自主运行的 Hermes 智能体经常需要在工作流之间传递凭据而不暴露于日志或内存中。Volta Notes 专为此设计——一个智能体创建笔记,将一次性 URL 传给下一个,密钥在读取时销毁。对话历史或工具输出日志中不会保留任何内容。
Windows(Claude Code CLI)
$(npm root -g) 语法在 PowerShell 或 CMD 中无效,请改用替代命令,或使用上述 Claude Desktop / npx 方法,该方法跨平台可用。
智能体提示词片段
将以下内容添加到任意智能体的系统提示词中即可启用安全凭据交接。
适用场景
- 用户向 AI 智能体传递 API 密钥、密码、凭据等敏感信息。
- 智能体向用户发送自毁链接形式的凭据。
- 智能体与智能体之间自主传递凭据,避免暴露于日志或内存。
限制
- 需要 Node.js 18+(使用内置 Web Crypto API)。
- 未读取的笔记在 7 天后过期。
- 笔记只能读取一次,第二次读取将失败。
故障排除
- 检查服务器是否已连接:应看到 volta: ... ✓ Connected,否则参考后续说明。
- 服务器未显示:是否使用了 claude mcp add?手动编辑 ~/.claude/mcp.json 无效——Claude Code 从自身注册表读取服务器,始终使用 claude mcp add 注册。
- node 是否在 PATH 中? Claude Code 的 shell 使用最小化 PATH。若找不到 node,请使用完整路径:claude mcp add -s user volta -- $(which node) $(npm root -g)/@voltanotes/mcp/dist/index.js
- 需要重启:添加或更改 MCP 服务器后,需完全重启 Claude Code(退出并重新打开)。
- 如何知道服务器已启动? 服务器成功启动时会向 stderr 输出 Volta MCP server started。运行 claude mcp list 可检查连接状态。
许可
MIT — Unprompted Labs