mcp-standardnotes

为 Claude 提供对您的 Standard Notes 保险库的安全读/写访问权限——端到端加密，仅限本地 stdio，无云端中间人。

您可以让 Claude 总结您的笔记、起草新笔记、整理标签、搜索整个保险库——所有这些操作都在您的主密钥保留在本地机器上的情况下完成。适用于 Claude Code、Claude Desktop 以及任何兼容 MCP 的客户端。

免责声明。 这是一个非官方的第三方集成。与 Standard Notes Ltd. 无关联、无背书，也未获得其赞助。“Standard Notes”是 Standard Notes Ltd. 的商标。

为什么选择它

• 🔒 端到端加密。 所有解密均在本地使用经过审计的 libsodium 原语（Argon2id + XChaCha20-Poly1305 IETF）完成。您的密码永远不会离开内存；您的主密钥永远不会离开您的机器。

• 🔌 仅限本地 stdio。 此服务器从不打开任何网络端口。

• 🔑 用于会话存储的操作系统钥匙串。 macOS Keychain、Linux libsecret、Windows Credential Vault——绝不使用明文文件。

• ☁️ 适用于官方云端或自托管的 Standard Notes 服务器。

功能

notes_create 和 notes_update 接受一个可选的 tags: string[]（标签 UUID），以便在写入时链接标签。

要求

• Node.js ≥ 20

• 使用 protocol 004 的 Standard Notes 账户（2020 年后创建或升级的任何账户的默认设置）

• 具有可用操作系统钥匙串的 macOS、Linux 或 Windows

快速入门

1. 安装

npm install -g mcp-standardnotes

或者，如果您愿意，可以从克隆版本运行：

git clone https://github.com/lozit/mcp-standardnotes.git
cd mcp-standardnotes
npm install && npm run build

2. 登录一次

mcp-standardnotes-login         # if installed globally
# or, from a clone:
npm run login

系统将提示您输入电子邮件和密码。密码会在内存中派生您的主密钥（Argon2id），且永远不会写入磁盘。加密的会话将存储在您的操作系统钥匙串中；后续运行将自动重用它。

3. 连接到 Claude

Claude Code — 添加到 ~/.claude.json 或 .mcp.json：

{
  "mcpServers": {
    "mcp-standardnotes": {
      "type": "stdio",
      "command": "mcp-standardnotes",
      "env": { "SN_EMAIL": "you@example.com" }
    }
  }
}

如果您使用克隆方式而不是 npm install -g，请将 command 替换为 node 的绝对路径，并添加 args: ["/absolute/path/to/mcp-standardnotes/dist/index.js"]。

然后使用 /mcp 重新连接。

Claude Desktop (macOS) — 使用相同的结构编辑 ~/Library/Application Support/Claude/claude_desktop_config.json，并使用指向您的 Node ≥ 20 二进制文件的绝对路径（Claude Desktop 不会继承 nvm）。如果您遇到 SyntaxError: Unexpected token '??='，请参阅 docs/troubleshooting.md。

任何其他 MCP 客户端 — 在环境中设置 SN_EMAIL 并运行 node dist/index.js。传输方式为 stdio。

自托管 Standard Notes？ 请参阅 docs/self-hosted.md 获取 docker-compose 配方以及如何固定您的 TLS 证书。

配置

安全概览

• 密码仅在密钥派生期间存在于 RAM 中。从不记录，从不存储。

• 会话 + 主密钥十六进制字符串仅存储在操作系统钥匙串中。绝不使用明文文件。

• 仅使用 stdio 传输。从不打开 HTTP 端口。

• 所有日志均发送至 stderr，并通过脱敏器路由，该脱敏器会屏蔽密码、密钥、JWT 和类似令牌的字符串。

• 所有工具输入均由 zod 验证。

• npm audit 的 HIGH/CRITICAL 漏洞是 CI 中的合并阻塞项。

• 仅在本地实现了 protocol 004 的帧处理；所有加密原语均来自 libsodium-wrappers-sumo。

完整的威胁模型和深度解析：docs/protocol-004.md。

故障排除

常见问题及修复：docs/troubleshooting.md。

注销

SN_EMAIL=you@example.com mcp-standardnotes-logout
# or, from a clone:
SN_EMAIL=you@example.com npm run logout

路线图

即将开展的工作记录在 ROADMAP.md 中。

贡献

欢迎贡献。请参阅 CONTRIBUTING.md 了解设置、测试和 PR 清单。

许可证

MIT — 使用它，分叉它，发布它。

致谢

• Standard Notes 提供加密设计和公共 API。

• Model Context Protocol 和 Anthropic 提供 MCP SDK。

• libsodium 由 Frank Denis 开发，通过 libsodium-wrappers-sumo 暴露。