Markmap MCP server
Mengonversi outline Markdown menjadi mind map interaktif dalam format file HTML, PNG, JPG, atau SVG yang dapat disimpan dan dipratinjau oleh AI client.
Juga dikenal sebagai jinzcdev/markmap-mcp-server
- Stars
- 289
- Tools
- 7
- Unduhan, 30 hari
- —
- Versi terbaru
- —
- Commit terakhir
- 4 Agu 2026
- Lisensi
- MIT
Apa itu Markmap MCP?
Mengonversi outline Markdown menjadi mind map interaktif dalam format file HTML, PNG, JPG, atau SVG yang dapat disimpan dan dipratinjau oleh AI client. Server ini menyediakan 7 tool, seperti markdown, format, filename.
Ringkasan dibuat dari README proyek
Tentang Markmap MCP server
Server ini memungkinkan developer yang menggunakan AI client seperti Claude Desktop atau Cursor untuk mengubah outline Markdown menjadi diagram visual. Dengan mengonversi heading dan nested list menjadi mind map interaktif, tool ini membantu pengguna memvisualisasikan struktur yang kompleks melalui format HTML, PNG, JPG, atau SVG. Seluruh proses berjalan secara lokal di mesin Anda, sehingga privasi tetap terjaga tanpa memerlukan API key pihak ketiga.
Pengguna dapat berinteraksi dengan server menggunakan tool seperti markdown_to_mindmap untuk menghasilkan file atau list_mindmaps untuk melihat output terbaru. Jika Anda membutuhkan ekspor gambar seperti PNG atau SVG, server akan menggunakan Playwright dan Chromium untuk melakukan konversi di sisi server. Anda dapat mengonfigurasi cara server mengembalikan data, baik berupa file path, inline HTML, atau konten gambar base64, bahkan dapat diatur untuk bekerja secara offline dengan menyertakan asset secara inline guna menghindari dependensi CDN.
Apa yang bisa Anda lakukan dengannya
- 1Visualisasi dokumentasi desainKonversi dokumen desain yang kompleks menjadi mind map terstruktur agar lebih mudah dipahami.
- 2Generate gambar siap pakai di chatBuat versi PNG dari sebuah outline sehingga AI dapat memberikan pratinjau gambar secara langsung di dalam chat.
- 3Konversi file markdown yang sudah adaUbah file markdown lokal menjadi mind map HTML interaktif menggunakan file path-nya.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Tool Markmap MCP 7
Terdeteksi dari READMEmarkdownformatfilenameopenlimitalltopic
| markdown | — | |
| format | — | |
| filename | — | |
| open | — | |
| limit | — | |
| all | — | |
| topic | — |
Konfigurasi
MARKMAP_DIRMARKMAP_OPENMARKMAP_RETURN_MODE
| Nama | Deskripsi | Tipe |
|---|---|---|
| MARKMAP_DIR | — | |
| MARKMAP_OPEN | — | |
| MARKMAP_RETURN_MODE | — |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkaujinzcdev/markmap-mcp-server is public and reachablegithub.com/jinzcdev/markmap-mcp-server ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-08-04github.com/jinzcdev/markmap-mcp-server ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelNo tool named like delete, drop or execLolos
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubMarkmap 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.
Pertanyaan tentang Markmap MCP
Tool apa yang disediakan Markmap MCP?
Server ini menyediakan 7 tool, termasuk markdown, format, filename, open, limit.
Apakah Markmap MCP server membutuhkan API key?
Tidak. Proses konversi berjalan sepenuhnya secara lokal, sehingga tidak memerlukan API key pihak ketiga.
Format gambar apa saja yang bisa diekspor?
Server dapat mengekspor PNG, JPG, atau SVG menggunakan Playwright, dan viewer HTML juga menyediakan tombol ekspor.
Apa saja persyaratan Node.js untuk MCP server ini?
Anda memerlukan Node.js v20 atau versi di atasnya, serta Playwright dengan Chromium untuk ekspor gambar di sisi server.
Di mana file mind map yang dihasilkan disimpan?
File akan disimpan di direktori output, yang secara default berada di ~/.markmap-mcp dan dapat dikonfigurasi melalui --output atau MARKMAP_DIR.