Markmap MCPサーバー
Markdownの構成案を、AIクライアントが保存・プレビュー可能なHTML、PNG、JPG、またはSVG形式のインタラクティブなマインドマップに変換します。
別名 jinzcdev/markmap-mcp-server
- スター
- 289
- ツール
- 7
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年8月4日
- ライセンス
- MIT
Markmap MCPとは
Markdownの構成案を、AIクライアントが保存・プレビュー可能なHTML、PNG、JPG、またはSVG形式のインタラクティブなマインドマップに変換します。 7個のツールを提供しており、markdown, format, filenameなどがあります。
プロジェクトのREADMEから生成された概要
Markmap MCP server について
このサーバーは、Claude DesktopやCursorなどのAIクライアントを使用する開発者が、Markdownの構成案を視覚的な図に変換することを可能にします。見出しやネストされたリストをインタラクティブなマインドマップに変換することで、HTML、PNG、JPG、またはSVG形式を通じて、複雑な構造を視覚化するのに役立ちます。プロセス全体がローカルマシン上で実行されるため、サードパーティのAPIキーを必要とせず、プライバシーも確保されます。
ユーザーは、ファイルを生成する markdown_to_mindmap や、最近の出力を表示する list_mindmaps といったツールを使用してサーバーを操作できます。PNGやSVGなどの画像エクスポートが必要な場合、サーバーはPlaywrightとChromiumを利用してサーバー側で変換を実行します。データの返却方法として、ファイルパス、インラインHTML、またはbase64形式の画像コンテンツを選択でき、CDNへの依存を避けるためにアセットをインライン化してオフラインで動作させる設定も可能です。
できること
- 1設計ドキュメントの視覚化複雑な設計ドキュメントを構造化されたマインドマップに変換し、理解を容易にします。
- 2チャット向けの画像生成構成案のPNG版を作成することで、AIがチャット内で直接画像のプレビューを提供できるようにします。
- 3既存のMarkdownファイルの変換ローカルのMarkdownファイルを、そのファイルパスを使用してインタラクティブなHTMLマインドマップに変換します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Markmap MCPツール 7
READMEから検出markdownformatfilenameopenlimitalltopic
| markdown | — | |
| format | — | |
| filename | — | |
| open | — | |
| limit | — | |
| all | — | |
| topic | — |
設定
MARKMAP_DIRMARKMAP_OPENMARKMAP_RETURN_MODE
| 名前 | 説明 | 種類 |
|---|---|---|
| MARKMAP_DIR | — | |
| MARKMAP_OPEN | — | |
| MARKMAP_RETURN_MODE | — |
自動チェック
実行日 2026年11月14日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能jinzcdev/markmap-mcp-server is public and reachablegithub.com/jinzcdev/markmap-mcp-server ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-08-04github.com/jinzcdev/markmap-mcp-server ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない7 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされているNo tool named like delete, drop or exec合格
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見る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
--offlineinlines 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
- Node.js v20 or above
- 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": {
"MARKMAP_DIR": "/path/to/output/directory",
"MARKMAP_OPEN": "never",
"MARKMAP_RETURN_MODE": "path"
}
}
}
}
Server preferences (CLI / env)
These are decided when the server starts — not tool arguments:
| Preference | CLI | Env | Values | Default |
|---|---|---|---|---|
| Output directory | --output / -o |
MARKMAP_DIR |
any directory path | ~/.markmap-mcp |
| Open in browser | --open [mode] |
MARKMAP_OPEN |
always | never | agent (bare --open = always) |
never |
| Return mode | --return-mode |
MARKMAP_RETURN_MODE |
path | content | both |
path |
| Offline HTML | --offline |
MARKMAP_OFFLINE |
true | false (CLI: pass --offline to enable) |
false |
CLI flags override environment variables. --output overrides MARKMAP_DIR.
--open: bare --open means always. You may also pass --open always|never|agent. An invalid value exits with an error. Without the flag, MARKMAP_OPEN is used (default never).
Return mode:
| Mode | Meaning |
|---|---|
path |
Paths JSON only (htmlFilePath + filePath) |
content |
Inline content only (raw HTML text, or a base64 image block) — no paths |
both |
Paths JSON plus inline content |
Generated HTML always includes the markmap toolbar, English export labels, and fully expanded nodes.
Example prompts
- “Summarize this design doc as a mind map.”
- “Convert
./notes/architecture.mdto a mind map.” - “Generate a PNG mind map of this outline for the chat.”
Available Tools
markdown_to_mindmap
Convert Markdown into an interactive mind map (and optionally an image).
| Parameter | Type | Default | Description |
|---|---|---|---|
markdown |
string | — | Markdown content (required unless inputPath is set). Wins when both are provided. |
inputPath |
string | — | Absolute path to a local .md file |
format |
html | png | svg | jpg |
html |
Output format. Image formats need Playwright |
filename |
string | auto | Output base name (sanitized; prefixed with markmap- if needed; reusing overwrites) |
open |
boolean | false |
Whether to open the result in browser. Only exposed when server open mode is agent (--open agent / MARKMAP_OPEN=agent). |
Return (returnMode=path):
{
"htmlFilePath": "/path/to/markmap-….html",
"filePath": "/path/to/markmap-….html"
}
For image formats, filePath is the image path and htmlFilePath is still the HTML source.
Return (returnMode=content): Raw HTML text block, or an MCP image content block (base64) for png/jpg/svg — no paths JSON. Oversized HTML (≥200KB) falls back to paths JSON.
Return (returnMode=both): Paths JSON plus the inline content above.
Note: Interactive zoom/collapse and the in-page “Export PNG/JPG/SVG” buttons are part of the HTML viewer. Server-side
format: png|jpg|svgis what Agents can consume directly without a manual browser click.
list_mindmaps
List recent generated files in the output directory (newest first). Only files whose names start with markmap are included.
| Parameter | Type | Default | Description |
|---|---|---|---|
limit |
number | 20 |
Max files to return (1–200) |
Returns {outputDir, files: [{name, filePath, size, mtimeMs, mtime}]}.
get_mindmap
Retrieve a generated mind map file by its absolute path. Path must stay inside the configured output directory (path traversal denied).
| Parameter | Type | Default | Description |
|---|---|---|---|
filePath |
string | — | Absolute path to the mind map file (HTML or image) |
Returns JSON {filePath, mimeType, size}. For HTML/SVG under 200KB, also appends a text content block. PNG/JPG return metadata only (no image block) — re-export via markdown_to_mindmap with format=png\|jpg if pixels are needed.
cleanup_mindmaps
Delete old (or all) generated mind map files.
| Parameter | Type | Default | Description |
|---|---|---|---|
maxAgeDays |
number | 7 |
Delete files older than this many days |
all |
boolean | false |
If true, delete all markmap files |
dryRun |
boolean | false |
If true, preview without deleting |
Prompt: mindmap_from_content
Helper prompt that asks the model to structure notes as Markdown, then call markdown_to_mindmap.
| Parameter | Type | Default | Description |
|---|---|---|---|
topic |
string | — | Topic or raw notes to organize as a map |
Related Projects
| Project | Description |
|---|---|
| MarkXMind Online | Create XMind mind maps with Markdown online. Try it → |
| Obsidian MarkXMind Plugin | Render XMindMark syntax as XMind mind maps inside Obsidian. |
License
This project is licensed under the MIT License.
Markmap MCPのよくある質問
Markmap MCPが提供するツールは
7個のツールを提供しており、markdown, format, filename, open, limitなどがあります。
Markmap MCP serverにAPIキーは必要ですか?
いいえ。変換はすべてローカルで実行されるため、サードパーティのAPIキーは必要ありません。
どのような画像形式でエクスポートできますか?
サーバー上でPlaywrightを使用してPNG、JPG、またはSVGをエクスポートできるほか、HTMLビューアーからもエクスポートボタンを利用できます。
このMCP serverのNode.jsの要件は何ですか?
Node.js v20以上が必要です。また、サーバー側での画像エクスポートにはChromiumを含むPlaywrightが必要です。
生成されたマインドマップのファイルはどこに保存されますか?
出力ディレクトリに保存されます。デフォルトは ~/.markmap-mcp ですが、--output または MARKMAP_DIR を使用して設定可能です。