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 (v25)

安装

手动安装

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

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

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

# 或者
markmap-mcp-server

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

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

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

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

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

使用方法

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

{
  "mcpServers": {
    "default-server": {
      "type": "streamable-http",
      "url": "http://localhost:3000/mcp",
      "note": "对于流式 HTTP 连接，在您的 MCP 客户端中直接添加此 URL"
    }
  }
}

安装 inspector @modelcontextprotocol/inspector

npm install -g @modelcontextprotocol/inspector

列出工具

mcp-inspector --cli --transport http --method tools/list --server-url --target http://localhost:3000/mcp

调用 markdown-to-mindmap 工具

mcp-inspector --cli --transport http --method tools/call --server-url --target http://localhost:3000/mcp --tool-name markdown_to_mindmap --tool-arg markdown="
# 标题 1
## 标题 1.1
- [x] 列表项 1
- [ ] 列表项 2
- [ ] 列表项 3
## 标题 1.2
- 子项 1
- 子项 2
## 标题 1.3
### 标题 1.3.1
### 标题 1.3.2
1. 序列 1
2. 序列 2
3. 序列 3
"

可用工具

markdown-to-mindmap

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

参数：

• markdown：要转换的 Markdown 内容（必需字符串）

返回值：

{
  "tools": [
    {
      "name": "markdown_to_mindmap",
      "title": "Markdown to Mind Map Converter",
      "description": "将 Markdown 内容转换为交互式 HTML 思维导图",
      "inputSchema": {
        "type": "object",
        "properties": {
          "markdown": {
            "type": "string",
            "description": "要转换为思维导图的 Markdown 内容"
          }
        },
        "required": ["markdown"]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "html": {
            "type": "string",
            "description": "生成的思维导图的 HTML 内容"
          },
          "contentLength": {
            "type": "number",
            "description": "HTML 内容的长度"
          },
          "success": {
            "type": "boolean",
            "description": "是否成功转换"
          },
          "error": {
            "type": "string",
            "description": "如果转换失败，错误信息"
          }
        },
        "required": ["html", "contentLength", "success"],
        "additionalProperties": false
      }
    }
  ]
}

许可证

本项目采用 MIT 许可证。