mcp-standardnotes

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）。密码绝不会离开 RAM；主密钥绝不会离开你的设备。
• 🔌 仅使用本地 stdio。 此服务绝不会开放网络端口。
• 🔑 使用操作系统钥匙串存储会话。 macOS Keychain、Linux libsecret、Windows Credential Vault——绝不使用明文文件。
• ☁️ 支持 Standard Notes 官方云端服务或可自托管服务。

功能

工具	功能
notes_list / notes_search / notes_get	浏览和搜索笔记（可用 tag: "<uuid-or-title>" 按标签筛选）
notes_create / notes_update / notes_delete	编写笔记（markdown、super、code、rich-text、task、spreadsheet、plain-text）
notes_create_many	一次同步推送，批量创建最多 50 条笔记
notes_stats	保管库统计信息：数量、大小、最早／最新／最大笔记
tags_list / tags_get / tags_create / tags_update / tags_delete	完整的标签 CRUD 操作
tags_attach / tags_detach	将标签关联到笔记或取消关联
sync	强制与服务同步

notes_create 和 notes_update 接受可选的 tags: string[]（标签 UUID），可在写入时关联标签。

要求

• Node.js ≥ 20
• 一个使用 协议 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），绝不会写入磁盘。加密会话会存储在操作系统钥匙串中；后续运行时会自动复用。执行 login 后，系统会询问你是否要一步将服务接入 Claude Desktop——接受后重启 Desktop 即可。

3. 接入 Claude

Claude Desktop（macOS / Windows）——最简单的方式，运行：

mcp-standardnotes-install

这会将正确的条目（绝对路径形式的 Node 和二进制文件路径，以及从钥匙串读取的邮箱）写入 ~/Library/Application Support/Claude/claude_desktop_config.json（Windows 上为 %APPDATA%/Claude/claude_desktop_config.json），并先备份任何现有配置。完全退出 Claude Desktop（⌘Q）后重新启动。

Claude Code——让 claude CLI 来完成：

mcp-standardnotes-install code   # prints the exact `claude mcp add` command

也可以手动添加到 ~/.claude.json / .mcp.json：

{
  "mcpServers": {
    "mcp-standardnotes": {
      "type": "stdio",
      "command": "mcp-standardnotes",
      "env": { "SN_EMAIL": "[email protected]" }
    }
  }
}

然后运行 /mcp 重新连接。

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

要自托管 Standard Notes？ 请参阅 docs/self-hosted.md，了解 docker-compose 配置示例以及如何固定 TLS 证书。

想让远程 Agent（VPS 上的 Hermes、自托管 LangGraph 等）使用你的保险库？ 请参阅 docs/remote-agent-bridge.md，了解完整的 Cloudflare Tunnel + MCP Portals 配置。你的主密钥会保留在 Mac 上；Agent 会与一个由 Cloudflare 服务令牌保护的公共 HTTPS 端点通信，而 Portals 会处理 MCP 工具的自动发现、多服务捆绑和 Access 应用生成。

配置

变量	默认值	说明
SN_EMAIL	必填	你的 SN 账户邮箱。必须与你运行 npm run login 时使用的邮箱一致。
SN_SERVER_URL	https://api.standardnotes.com	同步服务 URL。自托管实例请修改此值。
KEYCHAIN_SERVICE	mcp-standardnotes	覆盖钥匙串服务名称（适用于多个账户）。
SN_CERT_FINGERPRINT	未设置	自托管服务的 SHA-256 TLS 证书固定值（64 位十六进制字符，冒号可省略）。请参阅 docs/self-hosted.md。

安全概览

• 密码仅在密钥派生期间保留于 RAM 中。绝不记录，绝不存储。
• 会话和主密钥的十六进制值仅存储于操作系统钥匙串中。绝不写入明文文件。
• 仅使用 stdio 传输。绝不开启 HTTP 端口。
• 所有日志均写入 stderr，并通过脱敏器处理，以屏蔽密码、密钥、JWT 和类似令牌的字符串。
• 所有工具输入均由 zod 验证。
• npm audit 检测到 HIGH/CRITICAL 级问题时，会阻止 CI 合并。
• 本地仅实现 protocol 004 的帧格式；所有加密原语均来自 libsodium-wrappers-sumo。

完整威胁模型和深入说明：docs/protocol-004.md。 安全政策、漏洞报告和依赖项安全公告说明：SECURITY.md。

故障排除

常见问题及解决方法：docs/troubleshooting.md。

登出

[email protected] mcp-standardnotes-logout
# or, from a clone:
[email protected] npm run logout

路线图

后续工作记录在 ROADMAP.md 中。

参与贡献

欢迎贡献。请参阅 CONTRIBUTING.md，了解环境配置、测试和 PR 检查清单。

许可证

MIT——使用、分支或发布均可。

致谢

• 感谢 Standard Notes 提供加密设计和公共 API。
• 感谢 Model Context Protocol 和 Anthropic 提供 MCP SDK。
• 感谢 Frank Denis 开发的 libsodium，该库通过 libsodium-wrappers-sumo 提供。