Markmap MCPサーバーはModel Context Protocol(MCP)に基づいています。Markmapを用いてインタラクティブなマインドマップに変換し、オプションでサーバー上でPNG/JPG/SVG(変換)をエクスポートしてエージェントフレンドリーな配信が可能です。生成はローカルで実行され、サードパーティのAPIキーは不要です。

特徴

• Markdown → Mind Map:Markdown(見出し+ネストリスト)をインタラクティブなHTMLマインドマップに変換
• エージェントフレンドリーリターン:ファイルパス、インラインHTML、または画像コンテンツを返す(起動時に設定)
• サーバーサイドエクスポート:Playwright経由でチャット/インラインプレビュー用のPNG / JPG / SVGをエクスポート
• ブラウザプレビュー:設定可能なオープン動作 — 常に、決して、またはエージェント決定(スタートアップ設定)
• ブラウザエクスポートツールバー:HTMLを表示する際は、ページUI内のPNG/JPG/SVGもエクスポートするか、Markdownをコピーしてください
• オフラインHTML:スタートアップ--offlineでアセットをインライン化し、CDNアクセスなしでページが動作します
• ファイルワークフロー:inputPathから読み込み、最近の出力を一覧表示し、古いファイルの整理を行います
• プライバシー優先:完全ローカル変換;クラウドマインドマップAPIなし

前提条件

1. Node.js v20以上
2. サーバー側イメージエクスポート(format: png|jpg|svg)の場合:PlaywrightとChromiumをインストールします

Markmap MCP Server

Markmap MCP Server is based on the Model Context Protocol (MCP). It converts Markdown into interactive mind maps using markmap, and can optionally export PNG / JPG / SVG on the server for Agent-friendly delivery. Generation runs locally — no third-party API keys required.

Features

• Markdown → Mind Map: Convert Markdown (headings + nested lists) to interactive HTML mind maps
• Agent-friendly returns: Return a file path, inline HTML, and/or image content (configured at startup)
• Server-side export: Export PNG / JPG / SVG via Playwright for chat/inline preview
• Browser preview: Configurable open behavior — always, never, or agent-decided (startup setting)
• Browser export toolbar: When viewing HTML, also export PNG/JPG/SVG or copy Markdown in the page UI
• Offline HTML: Startup --offline inlines assets so the page works without CDN access
• File workflows: Read from inputPath, list recent outputs, clean up old files
• Privacy-first: Fully local conversion; no cloud mind-map API

Prerequisites

1. Node.js v20 or above
2. For server-side image export (format: png|jpg|svg): install Playwright and Chromium

npm install playwright
npx playwright install chromium

(playwright is an optional dependency of this package.)

Installation

# Install from npm
npm install @jinzcdev/markmap-mcp-server -g

# Basic run
npx -y @jinzcdev/markmap-mcp-server

# Specify output directory and auto-open in browser
npx -y @jinzcdev/markmap-mcp-server --output /path/to/output/directory --open always

Docker

docker build -t markmap-mcp-server .
docker run --rm -i \
  -v /path/to/output:/data/markmap \
  -e MARKMAP_DIR=/data/markmap \
  markmap-mcp-server

Or clone and run locally:

git clone https://github.com/jinzcdev/markmap-mcp-server.git
cd markmap-mcp-server
npm install && npm run build
# Optional: enable server-side image export
npx playwright install chromium
node build/index.js

Usage

Add the following configuration to your MCP client (Cursor / Claude Desktop / etc.):

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