Markmap MCP Server

Markmap MCP Server 是基于 Model Context Protocol (MCP)，允许一键将 Markdown 文本转换为交互式思维导图的服务器，构建于开源项目 markmap 之上。生成的思维导图支持丰富的交互操作，并可以导出为多种图像格式。

🎉 探索更多思维导图工具

尝试 MarkXMind - 一个使用简单的 XMindMark 语法创建复杂思维导图的在线编辑器。它支持实时预览、多格式导出（.xmind/.svg/.png），导入现有的 XMind 文件。立即尝试！

功能

• 🌠 Markdown 转思维导图：将 Markdown 文本转换为交互式思维导图
• 🖼️ 多格式导出：支持导出为 PNG、JPG 和 SVG 图像
• 🔄 交互操作：支持缩放、展开/折叠节点和其他交互功能
• 📋 Markdown 复制：一键复制原始 Markdown 内容
• 🌐 自动浏览器预览：选项自动在浏览器中打开生成的思维导图

预备条件

1. Node.js (v22 或以上)

安装

通过 Smithery 安装

要通过 Smithery 自动安装 Markmap MCP Server 到 Claude Desktop：

npx -y @smithery/cli install @jinzcdev/markmap-mcp-server --client claude

手动安装

# 从 npm 安装
npm install @jinzcdev/markmap-mcp-server -g

# 基础运行
npx -y @jinzcdev/markmap-mcp-server

# 指定输出目录
npx -y @jinzcdev/markmap-mcp-server --output /path/to/output/directory

或者，你可以克隆仓库并本地运行：

# 克隆仓库
git clone https://github.com/jinzcdev/markmap-mcp-server.git

# 导航到项目目录
cd markmap-mcp-server

# 构建项目
npm install && npm run build

# 运行服务器
node build/index.js

使用方法

在你的 MCP 客户端配置文件中添加以下配置：

{
  "mcpServers": {
    "markmap": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@jinzcdev/markmap-mcp-server"],
      "env": {
        "MARKMAP_DIR": "/path/to/output/directory"
      }
    }
  }
}

[!TIP]

服务支持以下环境变量：

• MARKMAP_DIR：指定思维导图的输出目录（可选，默认为系统临时目录）

优先级说明：

当同时指定了 --output 命令行参数和 MARKMAP_DIR 环境变量时，命令行参数具有优先级。

可用工具

markdown-to-mindmap

将 Markdown 文本转换为交互式思维导图。

参数：

• markdown：要转换的 Markdown 内容（必需字符串）
• open：是否自动在浏览器中打开生成的思维导图（可选布尔值，默认为 false）

返回值：

{
  "content": [
    {
      "type": "text",
      "text": "JSON_DATA_OF_MINDMAP_FILEPATH"
    }
  ]
}

许可证

本项目采用 MIT 许可证。