/ 目錄 / 演練場 / Markmap MCP Server
● 社群 jinzcdev ⚡ 即開即用

Markmap MCP Server

作者 jinzcdev · jinzcdev/markmap-mcp-server

只需調用一個工具,即可將任何Markdown大綱轉換為互動式思維導圖:平移、折疊、匯出PNG/JPG/SVG。

markmap-mcp-server將開放原始碼標記地圖轉譯器包裝為MCP工具。使用巢狀標題或項目符號清單提供Markdown ,取回在瀏覽器中打開的HTML思維導圖(可自動啟動) ,並匯出到PNG/JPG/SVG。對於會議摘要、腦力激盪捕捉、研究筆記以及任何時候平面輪廓更容易被視為一棵樹都很有用。

為什麼要用

核心特性

即時演示

實際使用效果

markmap-mcp-server.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "markmap-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ],
      "env": {
        "MARKMAP_DIR": "/path/to/output"
      }
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "markmap-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ],
      "env": {
        "MARKMAP_DIR": "/path/to/output"
      }
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "markmap-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ],
      "env": {
        "MARKMAP_DIR": "/path/to/output"
      }
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "markmap-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ],
      "env": {
        "MARKMAP_DIR": "/path/to/output"
      }
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "markmap-mcp-server",
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "markmap-mcp-server": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@jinzcdev/markmap-mcp-server"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add markmap-mcp-server -- npx -y @jinzcdev/markmap-mcp-server

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: Markmap MCP Server

將會議筆記變成心智圖,以便快速分享

👤 專案經理、團隊負責人執行大量備註同步 ⏱ ~10 min beginner

何時使用: 會議結束後,平面項目符號清單會隱藏討論的形狀。

前置條件
  • 節點18 + — nvm install 18
步驟
  1. 請客服人員草擬扣分項目
    將今天的規劃會議作為巢狀Markdown大綱進行摘要,其中包含頂級主題。✓ 已複製
    → 輪廓有3–5個熱門主題,巢狀子點
  2. 算繪
    在該大綱上執行markdown-to-mindmap ,並在瀏覽器中開啟。✓ 已複製
    → 互動思維導圖打開;節點收縮/擴展
  3. 匯出
    將地圖匯出至SVG ,並將檔案放入團隊文件。✓ 已複製
    → SVG已保存在MARKMAP_DIR下

結果: 可分享的心智圖,可編碼會議的形狀,而不僅僅是其文字。

注意事項
  • 輪廓太淺—一切都變成頂級節點 — 強制巢狀:要求主題子→點→支持事實
搭配使用: filesystem

從教科書章節建立學習地圖

👤 學生和終身學習者 ⏱ ~20 min beginner

何時使用: 您已經閱讀了一個章節,並希望在測驗前查看單一影像視覺效果。

步驟
  1. 總結本章內容
    將的第4章<book>作為階層式扣分大綱進行總結。✓ 已複製
    → 清除主題樹
  2. 轉譯和匯出
    產生思維導圖,並以PNG格式儲存在~/study/中。✓ 已複製
    → PNG檔案可供審核

結果: 一種視覺學習輔助工具,掃描需要幾秒鐘。

搭配使用: paper-fetch-skill

在撰寫完整圖表之前,請先草擬非正式架構地圖

👤 工程師在致力於draw.io/figma之前進行素描 ⏱ ~15 min intermediate

何時使用: 您想要一份2分鐘的「談話追蹤」圖,而不是一份精美的架構文件。

步驟
  1. 在Markdown中列出服務
    將此儲存庫中的服務概述為按網域分組的巢狀Markdown樹狀結構。✓ 已複製
    → 分組輪廓反映代碼庫結構
  2. 算繪
    將其轉換為思維導圖並匯出SVG。✓ 已複製
    → SVG ,您可以放入設計文件

結果: 幾分鐘內即可完成對話路徑圖;僅在需要時才升級到真實的架構圖。

注意事項
  • 把它當作最終神器 — 將其用作思考工具;發佈前替換為正式圖表
搭配使用: mermaid-skill

組合

與其他 MCP 搭配,撬動十倍槓桿

markmap-mcp-server + filesystem

閱讀長篇文件,摘要到Markdown大綱,呈現為思維導圖

讀取./notes/long-doc.md ,產生巢狀輪廓,然後將其呈現為思維導圖。✓ 已複製
markmap-mcp-server + mermaid-skill

選擇正確的視覺效果—流量的美人魚,階層的標記圖

決定這是流程(美人魚)還是階層(標記圖) ,並相應地渲染。✓ 已複製
markmap-mcp-server + paper-fetch-skill

獲取論文的摘要/章節,映射參數結構

取出論文,提取部分標題和關鍵點,將論點渲染為思維導圖。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
markdown-to-mindmap markdown: str, open?: bool 將巢狀Markdown大綱轉換為互動式心智圖 0

成本與限制

運行它的成本

API 配額
無—本地呈現
每次呼叫 Token 數
小:輪廓尺寸
費用
免費
提示
將輪廓保留到約100個節點以保持可讀性;較大的地圖平移/匯出速度較慢。

安全

權限、密鑰、影響範圍

憑證儲存: 無憑證—離線渲染
資料出站: 沒有網絡出口。字體和JS在本地捆綁。

故障排查

常見錯誤與修復

瀏覽器未開啟

設定open = false並手動開啟傳回的HTML路徑;確認已註冊預設瀏覽器。

驗證: open $(returned_path) on macOS
匯出的PNG為空白

請稍等片刻,地圖才會完全渲染完畢,然後再匯出。增加設定延遲或兩次執行匯出。

驗證: Open the HTML in a browser and check it renders before export
權限被拒絕寫入MARKMAP_DIR

將MARKMAP_DIR指向主目錄中的可寫入路徑。

驗證: touch $MARKMAP_DIR/.probe && rm $MARKMAP_DIR/.probe

替代方案

Markmap MCP Server 對比其他方案

替代方案何時用它替代權衡
mermaid-skill您的資料是流程或序列,而不是階層不同的圖表範例
excalidraw-skill你想要手繪的粗略視覺效果無自動佈局;手動定位
antv-chart你需要的是統計圖表,而不是思維導圖不同的輸出類別

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills