关于 Stickies
Stickies 是供 Agent 在项目 `.canvas` 文件中管理便笺的本地 MCP 服务。其 JSON Canvas 格式可在 Obsidian 中使用,修改也可通过 git 跟踪,同时保留文件中的其他数据。
主要功能
- 01列出便笺并按状态筛选
- 02添加、编辑和删除便笺
- 03设置便笺文本、颜色、位置和状态
- 04使用项目内的 JSON Canvas 文件
- 05保留手动编辑及其他画布数据
适用场景
- 01在项目看板上跟踪 Agent 任务
- 02在 Obsidian 中查看或更新便笺
- 03通过 git 查看便笺变更
MCP 相关
该服务向 MCP 客户端提供便笺读取和编辑工具。它通过 stdio 在本机运行,可操作项目内指定的 `.canvas` 或 `.json` 看板。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
4收录的工具列表 · 更新于 4 天前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| board | string | 否 | 要读取哪个白板。不填则使用默认白板。 |
| limit | integer | 否 | 便笺数量上限。默认值为 100。 |
| state | enum | 否 | 仅包含此状态的便笺。open | progress | done |
详细介绍
@getmurmur/stickies-mcp
一个 MCP 服务,让 Agent 能以开放的 Stickies 格式为你留下、阅读和勾选便笺。
便笺保存在项目中的 stickies.canvas 文件里。Stickies 文档是有效的 JSON Canvas,因此可以在 Obsidian 中作为画布打开,可以通过 git 查看变更,也可以将便笺粘贴到任何支持 Stickies 的应用中。
安装
Claude Code:
claude mcp add stickies -- npx -y @getmurmur/stickies-mcp
Codex、Cursor 和其他 MCP 客户端:
{
"mcpServers": {
"stickies": { "command": "npx", "args": ["-y", "@getmurmur/stickies-mcp"] }
}
}
需要 Node 22 或更高版本。它在你的机器上运行:无需账号或服务,也不会有任何内容离开你的项目。
工具
| 工具 | 功能 |
|---|---|
list_notes | 以 Stickies 文档的形式读取画布上的便笺。可按 state 筛选。 |
add_notes | 添加便笺。只需提供 text;新便笺会放在其他便笺下方。 |
update_notes | 按 ID 修改便笺的文本、颜色、位置或状态。设置 state: "done" 可勾选完成。 |
remove_notes | 按 ID 删除便笺及指向它们的箭头。 |
每个工具都可选用 board 参数,指定项目内的另一个 .canvas 或 .json 文件。
选项
| 选项 | 默认值 | |
|---|---|---|
--file <path> | stickies.canvas | 默认画布,相对于项目目录。 |
--root <dir> | 当前文件夹 | 项目文件夹。画布不能放在此文件夹之外。 |
--author <name> | Agent 使用的应用 | Agent 未指定作者时,新便笺的作者。若不设置,便笺会署上 Agent 使用的应用所报告的名称,例如 “Claude Code”。 |
如何处理你的文件
- 每次调用都会重新读取文件,因此不会覆盖在 Obsidian 中或手动进行的编辑。
- 会保留所有未修改的内容,包括其他类型的节点、箭头和其他应用的数据。
- 采用原子方式写入;如果文件不是有效的 JSON 或 Stickies 格式,则不会修改文件。
- Obsidian 生成的普通 JSON Canvas 文件也可使用。添加第一条便笺时,它会变成 Stickies 文档。
基于 MIT 许可证。属于 Stickies 项目,由 Murmur 制作:一款 Mac 应用,可在分支画布上与 Claude Code 和 Codex 一起进行思考。
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。