MCP 服务器

启动服务

接入 Claude Desktop

把这段加到

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

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

四个统一工具

• mddock_recall— 在本地知识库中检索相关片段。支持混合检索（默认）、纯词法、纯向量、图谱扩展和实体抽取，也可通过 shape/confidence_min/budget_tokens 实现 mini-KnowQL。
• mddock_read— 按路径、md:// URI、审计事件、harness 包或已安装的 memory pack 读取 markdown 表面。
• mddock_remember— 持久化会改变知识库的事实：写入记忆页、追踪 agent 行为者，或以审计日志方式编辑已有文档。
• mddock_propose— 提出工作区变更：市场搜索/查看、安装模块、解决同步冲突，或建议两篇文档之间的 wikilink。

默认只读

写操作通过 `mddock_remember`（带审计日志的直接编辑）或 `mddock_propose`（市场安装、冲突解决、关联建议）完成。提案会先在桌面客户端展示，确认后才会真正应用——agent 不能悄悄改你的笔记。

Cursor / Continue / 其他客户端

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

故障排查

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