Skip to main content
Glama

zhixi-mindmap-mcp

让 AI 直接改你的知犀思维导图:在已经打开的导图上增删改节点,改动实时显示在画布上,并自动同步到云端。

不是「生成一张新图给你」,是真的改你正在看的那张。


能干什么

能力

你可以这样说

找图

「考公文件夹里都有哪些导图」「搜一下名字带申论的」

管文档

「在申论下面新建一张导图叫『万能模板』」「把这张图挪到事业编」「这个文件夹改名」

读结构

「把这张导图的节点结构念给我听」

加节点

「在『安装系统』下面加三个子节点:分区、格式化、装系统」

加公式

「加一个节点写圆的方程 x²+y²=r²」——会自动排成真正的数学公式,不是文字

改文字

「把『组RAID1』改成『配置 RAID1』」

删节点

「删掉测试用的那个分支」

移动节点

「把『IPMI』整块挪到『硬件准备』下面」

截图

「截个图给我看看现在长什么样」

改完你抬头看屏幕就知道对不对,Ctrl+Z 还能撤销——它和你手动点出来的效果完全一样。一次加十几个节点也能撑住,内部走的是批量通道,单个节点约 1 秒多。

Related MCP server: xmind-mcp

数学公式

节点文字里用 $...$ 包住 LaTeX,就会渲染成知犀自己的公式对象(KaTeX 排版),和你在编辑器里点「公式」插进去的效果一模一样:

你说

实际写入的内容

圆的方程 x²+y²=r²

圆的方程:$x^2+y^2=r^2$

椭圆标准式

$\frac{x^2}{a^2}+\frac{y^2}{b^2}=1$

级数收敛

$\sum_{n=1}^{\infty}u_n$

一个节点里可以混排多段公式,公式之外的文字正常显示。zhixi_read_tree 读回来时也会还原成同样的 $...$ 写法,所以读出来再写回去不会丢公式。

不用自己加 $ 也行——直接说「加个节点写圆的方程 x²+y²=r²」,AI 会转成上面的写法。


安装:交给 AI,别自己敲命令

把下面整段粘给任意能执行命令的 AI(WorkBuddy / Claude Code / Cursor / Codex 都行):

帮我安装并配置 zhixi-mindmap-mcp 这个 MCP 服务。

仓库地址:https://github.com/szr0728/zhixi-mindmap-mcp

请你全程自己动手,按顺序做完,最后用一段话告诉我结果:

1) 把仓库 clone 到一个长期保留的目录(Windows 建议 C:\Tools\zhixi-mindmap-mcp,别放临时目录),
   然后 npm install。国内网络慢就加参数 --registry=https://registry.npmmirror.com

2) 取到 node 的绝对路径(执行 node -e "console.log(process.execPath)" 的输出),备用。

3) 编辑用户级 MCP 配置文件:~/.workbuddy/mcp.json
   (Windows 即 C:\Users\<用户名>\.workbuddy\mcp.json;文件不存在就新建,内容是 {})
   在 mcpServers 里【追加】一条 zhixi,不要覆盖已有条目,合并后的结构是:

   {
     "mcpServers": {
       "zhixi": {
         "command": "<第2步拿到的 node 绝对路径>",
         "args": ["<仓库目录绝对路径>/src/index.js"],
         "env": { "ZHIXI_CDP_PORT": "19222" }
       }
     }
   }

   注意:Windows 路径在 JSON 里要么用双反斜杠,要么用正斜杠。

4) 检查知犀客户端有没有开调试端口:
   curl http://127.0.0.1:19222/json/version
   - 有返回 → 跳过
   - 连不上 → 说明客户端没在带调试端口运行。知犀是单实例的,先确认它已完全退出
     (窗口关掉、右下角托盘图标也要退出),再执行仓库里的 start-zhixi.cmd

5) 告诉我:WorkBuddy 只在启动时读取 mcp.json,必须【完全退出客户端再重新打开】
   (含托盘),重开后到「专家·技能·连接器 → 连接器 → 右上角自定义连接器」里
   找到 zhixi,点「信任」。这一步必须我自己点,你没法代劳。

6) 我信任完之后,你来验证:先调用 zhixi_status 看连通性,再 zhixi_list_maps 列出导图,
   用 zhixi_open_map 打开其中一张,然后 zhixi_read_tree 把节点树摘要给我看。
   如果哪一步失败,把具体报错告诉我并给出修复方案。

AI 拿到这段会自己 clone、装依赖、找 node 路径、改配置、检查端口。你只需要在最后点一次「信任」。

想换目录或端口,只改提示词里的路径和 ZHIXI_CDP_PORT 就行。


手动安装(不想用 AI 的话)

  1. git clone https://github.com/szr0728/zhixi-mindmap-mcp.git && cd zhixi-mindmap-mcp && npm install

  2. 把 mcp.example.json 的内容合并进 ~/.workbuddy/mcp.json,路径换成绝对路径

  3. 双击 start-zhixi.cmd 启动知犀(已开着的话先彻底退出)

  4. 完全重启宿主客户端 → 连接器面板点「信任」→ 开新会话

Claude Desktop 等其它宿主同理,配置文件换成 claude_desktop_config.json。


三个容易踩的坑

坑

说明

改完配置没反应

宿主只在启动时读 mcp.json,必须完全退出重开,不是关窗口

端口起不来

知犀单实例。已经在跑普通实例时,带参数再启动无效,得先从托盘退干净

界面「改了不动」

客户端必须带 start-zhixi.cmd 里那三个 --disable-* 参数启动,否则窗口被遮挡时 Chromium 停止渲染


技术原理、实现细节、已知限制见 TECHNICAL.md。

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to interact with TheBrain's knowledge management system through natural language for managing thoughts, notes, and attachments. It supports core features like full-text search, relationship mapping, and file uploads to streamline digital brain organization.
      3
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to read and write XMind mind map files, allowing generation, editing, and analysis of mind maps directly in XMind.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to build and interact with mind maps on mindmap.io. Agents can create, read, update, and delete maps and nodes, run prompts on nodes, and auto-expand topics into follow-up questions.
      13
      MIT