MindNode MCP 服务器

将 MindNode 连接到 Claude 及任何 AI 智能体——一个 为这款没有 API、没有 AppleScript、也没有可导出文件的思维导图应用打造的 MCP 服务器。

MindNode Next（2024+ 一代的 MindNode）将所有文档迁移到了私有 SQLite/CRDT 库中，并且零自动化接口：没有 AppleScript 字典、没有 CLI、 没有云 API，甚至磁盘上也不再存在 .mindnode 文件。本项目逆向工程了其存储 格式，让 AI 智能体终于能够读取和创建思维导图：

• 读取任何思维导图为 Markdown 大纲——直接从 MindNode 的本地库中读取 （SQLite → protobuf → Apple LZ4 → CRDT 解码），只读操作，甚至无需启动应用。

• 查看精确的渲染图——MindNode 自带的预览 JPEG，像素级完美。

• 创建新的思维导图（从 Markdown 大纲静默导入到应用中）。

• 通过 mindnode:// URL 方案按名称打开任何导图。

适用于 Claude Code、Claude Desktop 以及任何 MCP 客户端。

在寻找基于经典文件的 MindNode？旧版基于 plist 的工具可以处理 .mindnode 文档；本服务器面向 MindNode Next（2024+），即 SQLite 库这一代，旧方法已不再适用。已在 MindNode 2026.4.4 上验证。

工具

安装

需要装有 MindNode 2024+ 的 macOS 和 Node.js ≥ 24。

Claude Code：

claude mcp add --scope user mindnode -- npx -y mindnode-mcp

Claude Desktop / 任何 MCP 客户端（claude_desktop_config.json）：

{
  "mcpServers": {
    "mindnode": {
      "command": "npx",
      "args": ["-y", "mindnode-mcp"]
    }
  }
}

从源码安装（Node ≥ 24 直接运行 TypeScript，无需构建步骤）：

git clone https://github.com/jyuwaaw/mindnode-mcp.git
cd mindnode-mcp && npm install
claude mcp add --scope user mindnode -- node /path/to/mindnode-mcp/src/index.ts

使用 MCP 检查器调试：npm run inspect。

我的使用方式

我保留一张每日思维导图（每天一张，外加每个项目一张）作为我的工作 记忆——Raycast 已设置为单次按键即可唤起 MindNode，因此捕捉一个想法 几乎零成本。这个服务器闭环了工作流：一天结束时，智能体读取导图， 将其转化为工作日志或博客草稿，并可以从未完成的话题中为明天的导图 播种。可以这样问 Claude：

• "列出我的思维导图"

• "读取今天的导图并起草一份站会更新"

• "把这个大纲变成思维导图：……"

工作原理

MindNode Next 将所有内容存储在其沙盒容器内的 GRDB/SQLite 库中。 每个文档是一个 protobuf 基础快照，外加一串 CRDT 操作批次， 两者都包裹在一个微型信封中（字段 12345 = 版本，字段 678910 = 载荷—— 没错，就是这样），并使用 Apple 的 LZ4 帧格式（bv41/bv4-/bv4$ 块） 压缩。

本仓库包含一个无模式的 protobuf 解析器、一个纯 TypeScript 的 Apple-LZ4 解码器，以及一个重放节点创建和文本操作的重建器。 完整的逆向工程笔记见 docs/FORMAT.md—— 如果你想构建自己的 MindNode 工具，从这里开始。 tools/spelunk.py 可以美化打印任何库数据块， 便于进一步挖掘。

写入操作刻意不触碰数据库（它由 CloudKit 同步；损坏它将不可原谅）。 新文档通过 MindNode 自带的 Markdown 导入器（open -a MindNode）创建， 该过程静默且无损。

注意事项

• get_mindmap 从 CRDT 操作流中重建文本，而该流的位置编码尚未完全 映射：大量编辑过的字符串可能略有错乱，已删除的节点可能残留为 (untitled)。当精确性至关重要时，请使用 get_mindmap_image。 通过 create_mindmap 创建的文档可以无损读回。

• create_mindmap 会启动 MindNode（导入在应用内静默完成）。

• 库始终以只读方式访问。格式已在 MindNode 2026.4.4 上验证； 未来的 MindNode 更新可能改变字段编号——如果大纲读回为空， 请附上 tools/spelunk.py 的输出提交 issue。

路线图

• 节点级编辑（添加/重命名/删除单个节点），以及通过 MindNode 的 20 个 App Intents（CreateNode、EditNode、ExportDocument 等）封装在 Shortcuts 中实现无损导出

• 映射 CRDT 文本位置编码和删除操作，实现精确读取

• 文件夹标题、标签/贴纸、备注字段

许可证

MIT