CLI 与 MCP

把笔记库接入 Claude Desktop / Cursor / claude-cli 等支持 MCP 的 AI 工具，让 AI 直接搜索、读写、整理你的本地笔记。命令行工具叫 zskcli，直连本地知识库，不打开 GUI 也能跑。

适用 v1.6.0，Apple Silicon（M 系列）Mac。Intel Mac 需联系提供方获取对应版本。

三步接入

1. 安装并启动一次 App —— 把 Donkey的百宝箱.app 拖进「应用程序」并打开一次，会自动安装命令行工具 zskcli。终端验证：

```bash
zskcli --help
```

若提示 command not found，手动建链接一次（需输入开机密码）：

```bash
sudo ln -sf "/Applications/Donkey的百宝箱.app/Contents/Resources/binaries/zskcli" /usr/local/bin/zskcli
```

2. 设默认知识库 —— 换成你存放笔记的文件夹：

```bash
zskcli vault use /Users/你的用户名/你的知识库
```

3. 在 AI 工具里加 MCP 配置 —— 以 Claude Desktop 为例，编辑 ~/Library/Application Support/Claude/claude_desktop_config.json，把路径换成第 2 步的路径后重启：

```json
{
"mcpServers": {
"zsk": {
"command": "/usr/local/bin/zskcli",
"args": ["--vault", "/Users/你的用户名/你的知识库", "mcp-server"]
}
}
}
```

其他 AI 工具

任何支持 stdio MCP 的工具都能接，参数一致：command 用绝对路径 /usr/local/bin/zskcli（图形界面工具读不到 shell 的 PATH），args 为 ["--vault", "<你的知识库路径>", "mcp-server"]。也可用环境变量 ZSK_VAULT 代替 --vault。

• Claude Desktop：~/Library/Application Support/Claude/claude_desktop_config.json
• Cursor：设置 → MCP → Add Server
• claude-cli：claude mcp add

接入后能做什么

AI 获得对笔记库的 37 个工具，覆盖：笔记（读写、新建、追加、重命名、回收站）、搜索（文件名 / 全文 / 标签）、双向链接（反向链接、出链、未解析链接、重命名联动改引用）、知识图谱、画布 Canvas（流程图 / 树图 / 看板）、标签统计、链接索引、库管理。

可以直接对 AI 说：「搜一下所有提到『产品规划』的笔记」「新建今天的会议记录」「把『旧方案』重命名为『方案 V2』并自动更新所有引用」。

常见问题

• 找不到 zskcli：先打开一次 App；仍不行就执行上面的 sudo ln -sf 手动建链接。
• MCP 连接失败：多半是没设知识库。确认做了 zskcli vault use，或配置里写了 --vault / ZSK_VAULT；可用 zskcli --vault <路径> vault info 自测。
• command 要写绝对路径？：是的。图形界面工具不继承终端 PATH，统一用 /usr/local/bin/zskcli。