← 文档

MCP 服务器

docs.mcp.intro

启动服务

接入 Claude Desktop

把这段加到

（macOS）或对应平台的等价文件：

重启 Claude，下面这十个工具就会出现在 MCP 选择器里。

十个工具

  • mddock_search— 对本地知识库做混合检索（BM25 + 向量）
  • mddock_read— 按路径或 md:// URI 读取文档
  • mddock_write— 新建或更新文档（默认走提案流程）
  • mddock_install— 把已发布的项目 fork 到工作区
  • mddock_publish— 把当前项目发布到市场
  • mddock_resolve— 把 md:// 解析为当前字节 + sha256
  • mddock_skill_register— 为当前工作区注册一个 skill 端点
  • mddock_resolve_conflict— 对冲突文档执行三方合并
  • mddock_dream_run— 跑一次 dream 循环（提取 / 压实 / 建议 / 修剪）
  • mddock_audit— 校验当前知识库的哈希链

默认只读

可写工具（mddock_write、mddock_publish、mddock_resolve_conflict）写入的是「提案库」而非直接落地到知识库。你在桌面客户端里审核后才会真正应用——agent 不能悄悄改你的笔记。

Cursor / Continue / 其他客户端

任何符合 MCP 的客户端都可以用。底层是普通的 stdio JSON-RPC，不需要 MDDock 自有粘合层。只读 HTTP 接口（无需 MCP）见 /docs/agent-protocol。

故障排查

  • •mddock doctor —— 检查工作区、schema、二进制版本
  • •日志位置：~/.mddock/logs/mcp.log
  • •如果客户端里少工具，先在终端跑 mddock mcp --json 确认能正常启动