Markmap

🚀 Markmap MCP 服务器

Markmap MCP 服务器基于模型上下文协议（MCP），可一键将 Markdown 文本转换为交互式思维导图。它基于开源项目 markmap 构建，生成的思维导图支持丰富交互操作，还能输出多种图像格式，为用户使用 Markdown 提供了极大便利。

✨ 主要特性

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

📦 安装指南

先决条件

1. 需安装 Node.js 运行时环境。

安装方式

通过 Smithery 安装

要通过 Smithery 自动安装 Markmap MCP 服务器以供 Claude 桌面使用，可执行以下命令：

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",
        "--output",
        "/path/to/output/directory"
      ]
    }
  }
}

高级用法

安装依赖

npm install @jinzcdev/markmap-mcp-server

示例配置文件

{
  "mcpServers": {
    "markmap": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ]
    }
  }
}

使用示例

npx @jinzcdev/markmap-mcp-server

💡 使用建议

该服务支持以下环境变量：

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

优先级说明：

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

📚 详细文档

代码仓库

GitHub - markmap-mcp-server

贡献者

• Jin ZC

📄 许可证

MIT License