Scratchpad

Scratchpad MCP 服务

把你的笔记交给 AI。 这是一个适用于 Scratchpad 的 MCP 服务，让 Claude、Cursor、Codex 和其他任何 MCP 客户端都能搜索、阅读、编写和整理你已有的笔记。

它刻意保持轻量：大约 2,000 行 TypeScript，没有数据库，也不会在磁盘上保存状态。每个工具只需调用 Scratchpad 的 HTTPS API 一到两次，因此你可以在一个晚上读完整个项目，并确切了解助手能做什么。

两种连接方式

远程（推荐）

无需安装。让客户端连接到托管服务，然后使用 OAuth 登录。这是唯一适用于手机的方式。

https://app.scratchpad.sh/api/mcp

Claude Code：

claude mcp add --transport http --scope user scratchpad https://app.scratchpad.sh/api/mcp

Cursor，在 ~/.cursor/mcp.json 中：

{
  "mcpServers": {
    "scratchpad": { "url": "https://app.scratchpad.sh/api/mcp" }
  }
}

本地（stdio）

适用于只支持 stdio 的客户端，或你更愿意使用 API 令牌而非 OAuth 会话的情况。在 Scratchpad 的 Settings、API tokens 下创建令牌。

{
  "mcpServers": {
    "scratchpad": {
      "command": "npx",
      "args": ["-y", "@scratchpadsh/mcp"],
      "env": { "SCRATCHPAD_TOKEN": "scr_your_token" }
    }
  }
}

连接前检查令牌：

SCRATCHPAD_TOKEN=scr_your_token npx -y @scratchpadsh/mcp --check

变量
SCRATCHPAD_TOKEN	必需	read 可用于搜索和阅读。任何写入操作都需要 full。
SCRATCHPAD_URL	可选	默认为 https://app.scratchpad.sh。

工具

类别	工具
查找和阅读	search_notes、read_note、list_notes、list_folders
附件	search_attachment、read_attachment
写入	create_note、append_to_note、propose_edit、apply_edit
整理	move_note、rename_note、archive_note、pin_note、duplicate_note
文件夹	create_folder、rename_folder、move_folder、delete_folder
历史记录	list_versions、read_version、restore_version

每个名称都带有 scratchpad_ 前缀，因此这些工具可以与同一会话中的其他服务并列使用。

专为防止模型悄悄破坏你的笔记而设计

• 没有删除笔记的工具。 删除笔记仍由你亲自处理。
• 编辑分为两步。 propose_edit 不会写入任何内容：它会返回差异和一个 ID。apply_edit 接收该 ID，不接收内容，因此从向你展示差异到实际写入之间，文本不会发生变化。
• 编辑会检查基准版本。 如果提议后笔记发生了变化，编辑就会被拒绝，而不会覆盖你输入的内容。
• 每次编辑都可以撤销。 历史记录会保留较早的版本，而 restore_version 会先保留当前版本。
• **密码锁定的笔记始终不可见，**令牌和连接器都无法访问。
• **工具带有注释，**因此客户端可以自由执行读取操作，并在每次写入前停下来向你展示。

开发

npm install
npm test

许可证

MIT。请参阅 LICENSE。

由 Scratchpad 制作，这是一款 AI 真正能读取的笔记应用。更多信息请访问 scratchpad.sh/ai。