SoloMD MCP 服务

每个 SoloMD 发行版都附带 solomd-mcp —— 一个支持 Model Context Protocol 的边车二进制。把 Claude Desktop、Codex CLI、Cursor 等 MCP 客户端指向它， AI 就可以直接列出、搜索、读取、写入你的笔记仓库 —— 不必复制粘贴。

为什么这件事重要

大多数笔记工具把 AI 当作编辑器里的一个功能：粘贴一段、改写一段。SoloMD 反过来：把你的整个仓库交给 AI 客户端，于是你可以让模型回答「帮我总结所有 Q2 规划相关的笔记」或「帮我接着上周会议的笔记起草一份后续邮件」—— 模型直接读真实文件。

快速接入 — Claude Desktop

打开 SoloMD → 设置 → 集成 → MCP 服务。
点击 复制 Claude Desktop 配置。生成的 JSON 已经自带边车二进制路径和你当前打开的工作区目录。
点击 打开 Claude Desktop 配置文件，粘贴进 "mcpServers" 节，保存。
重启 Claude Desktop —— solomd-vault 出现在工具菜单里，搞定。

模型可以调用的工具

工具	用途
`list_notes`	列出工作区里所有 Markdown 文件。
`read_note`	按相对路径读取一篇笔记，返回正文 + Front Matter。
`search`	全文搜索，返回排序后的片段。
`get_backlinks`	列出所有 `[[wiki 链接]]` 指向目标笔记的笔记。
`list_tags`	列出仓库里所有 `#标签` 及使用次数。
`get_outline`	返回一篇笔记的标题树 —— 长文件改之前先取大纲很有用。
`write_note`	新建或覆盖文件。默认禁用，见下文。
`append_to_note`	在现有笔记末尾追加内容。默认禁用。

默认只读

solomd-mcp 只在加 --allow-write 启动时才暴露写入工具。设置面板复制出来的默认配置是只读的。要打开写入权限，编辑 args：

{
  "mcpServers": {
    "solomd-vault": {
      "command": "/path/to/solomd-mcp",
      "args": ["--workspace", "/path/to/your/notes", "--allow-write"]
    }
  }
}

把读和写拆成两个开关，是为了让一次「搜索」请求绝对不会顺手改掉你的笔记 —— 必须自己显式开。

其他客户端

任何会 MCP 的客户端都能用：Codex CLI、Cursor、Continue、Zed 的 MCP 客户端、开源的 mcp-cli —— 它们的配置形态完全一样，把 command 和 args 指向同一个二进制即可。

二进制在哪儿

macOS 上边车在 SoloMD.app/Contents/MacOS/solomd-mcp 里； Windows 和 Linux 上则在主程序旁边。设置面板里 已捆绑于 … 一栏会显示绝对路径，不用自己找。