Volta Notes

@voltanotes/mcp

适用于 Volta Notes 的 MCP 服务——让任何 AI Agent 都能创建和读取阅后即焚的加密笔记。

笔记采用 AES-256-GCM 进行端到端加密。解密密钥仅存在于 URL 片段中，绝不会发送到任何服务。笔记存储在 Internet Computer 上，并在读取一次后永久销毁。

为什么要用

AI Agent 在运行时经常需要敏感信息，例如 API 密钥、密码和凭据。如今，用户会把这些信息粘贴到聊天中，导致它们永久保存在对话记录里。

借助这个 MCP 服务，流程变为：

1. 用户在 voltanotes.com 创建笔记并发送一次性 URL
2. Agent 调用 read_volta_note——返回秘密内容，笔记随即永久销毁
3. 敏感信息绝不会出现在聊天记录中

反过来也可以——Agent 可以使用 create_volta_note，通过自毁链接向用户发送凭据。

快速开始

Claude Code（CLI 和桌面应用）

步骤 1——全局安装：

npm install -g @voltanotes/mcp

步骤 2——注册服务：

claude mcp add -s user volta -- node $(npm root -g)/@voltanotes/mcp/dist/index.js

完成。重启 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：

{
  "mcpServers": {
    "volta": {
      "command": "npx",
      "args": ["-y", "@voltanotes/mcp"]
    }
  }
}

其他兼容 MCP 的客户端

上述 npx 配置适用于任何支持标准 command/args MCP 格式的客户端，包括 Cursor、Windsurf、Cline、Continue.dev 等。请查阅客户端的 MCP 文档，了解在哪里添加服务配置。

Hermes Agent（Nous Research）

Volta MCP 可通过 Hermes Agent 的 MCP 集成使用。将服务添加到 Hermes 配置（~/.hermes/config.yaml）：

mcp:
  servers:
    - name: volta
      command: npx
      args:
        - "-y"
        - "@voltanotes/mcp"

重启 Hermes 后，Agent 即可使用 create_volta_note 和 read_volta_note 工具。

Agent 间协作场景： 自主运行的 Hermes Agent 经常需要在不同工作流之间传递凭据，同时避免将凭据暴露在日志或记忆中。Volta Notes 正是为此而设计——一个 Agent 创建笔记，将一次性 URL 传给下一个 Agent，秘密内容便会在读取时销毁。对话记录或工具输出日志中不会留存任何内容。

完整配置选项请参阅 Hermes MCP 文档。

Windows（Claude Code CLI）

$(npm root -g) 语法在 PowerShell 或 CMD 中不起作用。请改用：

claude mcp add -s user volta -- node "%APPDATA%\npm\node_modules\@voltanotes\mcp\dist\index.js"

或者使用上面的 Claude Desktop / npx 方法，这些方法支持跨平台使用。

工具

create_volta_note

创建加密笔记并返回一次性 URL。

参数	类型	说明
content	string	要加密的秘密内容（最大 2 KB）

返回： 一个 voltanotes.com URL。接收者打开一次，读取内容后，笔记便会永久消失。

read_volta_note

读取并永久销毁 Volta 笔记。

参数	类型	说明
url	string	完整的 Volta URL，包含 # 片段

返回： 解密后的笔记内容。笔记会从 canister 中永久删除，再次读取将失败。

Agent 提示词片段

将以下内容添加到任意 Agent 的系统提示词中，即可启用安全凭据交接：

When you need a secret from the user (API key, password, credentials):
1. Ask them to go to voltanotes.com and paste the secret into the note field
2. They'll get a one-time URL — ask them to send it to you
3. Use the read_volta_note tool with that URL to retrieve the secret
The secret is permanently destroyed after you read it — it never appears in chat history.

安全模型

• AES-256-GCM 加密在本地完成，然后才会将任何内容发送到 canister
• 加密密钥只存在于 URL 片段（#...）中——浏览器和服务端永远不会传输片段
• ICP canister 只存储密文——即使遭到入侵，所有数据也都无法读取
• 笔记首次读取后即销毁。未读取的笔记会在 7 天后过期。
• 无账号、无需登录、不追踪

工作原理

Agent calls create_volta_note("secret-api-key-123")
  → Local: generate AES-256 key + encrypt
  → ICP canister: store ciphertext → returns noteId
  → Return URL: voltanotes.com/r/{noteId}#{key}

User opens URL → read gate → clicks "Read note"
  → Browser: fetch ciphertext from canister (canister deletes it)
  → Browser: decrypt using key from # fragment
  → Display plaintext — note is gone forever

故障排除

检查服务是否已连接

claude mcp list

你应该能看到 volta: ... ✓ Connected。如果没有，请参阅下文。

服务未显示

1. 是否使用了 claude mcp add？ 手动编辑 ~/.claude/mcp.json 不会生效——Claude Code 会从自己的注册表读取服务。请始终使用 claude mcp add 注册服务。

2. node 是否在 PATH 中？ Claude Code 的 Shell 使用精简的 PATH。如果找不到 node，请使用完整路径：

   claude mcp add -s user volta -- $(which node) $(npm root -g)/@voltanotes/mcp/dist/index.js
   

3. 需要重启。 添加或更改 MCP 服务后，请完全重启 Claude Code（退出并重新打开）。

如何确认服务已启动？

服务成功启动后，会将 Volta MCP server started 记录到 stderr。运行 claude mcp list 检查连接状态。

要求

• Node.js 18+（使用内置 Web Crypto API）

许可证

MIT — Unprompted Labs