Markmap MCP Server：将 Markdown 一键转化为交互式思维导图

项目概述

Markmap MCP Server 是一个基于 Model Context Protocol 的服务端工具，npm 包名为 @jinzcdev/markmap-mcp-server，当前版本 v0.1.1，MIT 协议开源。它的核心功能是将 Markdown 文本转换为交互式思维导图，底层基于开源项目 markmap 实现可视化渲染。

项目的设计思路清晰：Markdown 的标题层级天然适合表达树状结构，而 markmap 是成熟的开源思维导图渲染方案。将二者通过 MCP 协议 桥接，LLM 即可在对话中直接生成可交互、可导出的思维导图，无需用户手动操作任何图形界面工具。

技术实现

项目采用 TypeScript 开发，核心依赖包括 @modelcontextprotocol/sdk（MCP 协议通信）、markmap-cli（思维导图 HTML 生成）、zod（参数校验）、pino（结构化日志）。源码分为四个模块：入口层负责 CLI 参数解析和服务初始化，MCP 协议层注册工具并处理客户端请求，核心转换层调用 markmap-cli 生成 HTML，工具层提供文件导出（PNG/JPG/SVG）等辅助功能。MCP 服务端通过 stdio 传输与客户端通信，接受 LLM 传入的 Markdown 内容，调用 markmap-cli 生成交互式 HTML 页面，并将文件路径返回给 LLM。

功能特性

生成的 HTML 页面支持完整的交互操作：鼠标缩放、节点展开与折叠、拖拽平移。这些交互能力直接继承自 markmap，无需额外开发。

支持将思维导图导出为 PNG、JPG 和 SVG 三种格式。这对需要将思维导图嵌入文档、幻灯片或分享到社交媒体的场景非常实用。导出功能在服务端完成，无需用户安装额外依赖。

通过命令行参数 --output 或环境变量 MARKMAP_DIR 指定输出目录，通过 open 参数可让服务端自动在默认浏览器中打开生成的思维导图。

与同类方案对比

多数思维导图方案依赖专门的图形界面软件（如 XMind、MindNode）或在线服务。Markmap MCP Server 通过 MCP 协议将能力注入 AI 对话流程，LLM 可以直接根据讨论内容实时生成思维导图，而不需要用户手动将文本复制到其他工具中。底层基于 MIT 开源的 markmap，生成的 HTML 文件完全自包含，无需任何后端服务即可在浏览器中完整运行。这意味着思维导图可以独立保存、分享和归档。

作者还有两个相关项目值得关注：MarkXMind Online（Markdown 在线创建 XMind 思维导图）和 Obsidian MarkXMind 插件，形成了一个围绕 Markdown 思维导图的完整工具生态。

总结

Markmap MCP Server 是一个小而专的工具：它只做一件事——将 Markdown 转为思维导图——但这件事做得干净利落。对于一个 MCP 工具而言，这种单一职责的设计恰恰是最佳实践：输入明确、输出确定、无副作用。在 MCP 生态快速扩张的当下，这类将现有成熟开源能力通过标准协议接入 AI 对话的工具正在形成一个重要趋势。

---

项目地址：github.com/jinzcdev/markmap-mcp-server
npm 包：@jinzcdev/markmap-mcp-server
当前版本：v0.1.1
开源协议：MIT