Markmap MCP sunucusu
Markdown taslaklarını, yapay zeka istemcilerinin kaydedip önizleyebileceği HTML, PNG, JPG veya SVG formatlarında etkileşimli zihin haritalarına dönüştürür.
Ayrıca bilinen adı jinzcdev/markmap-mcp-server
- Yıldızlar
- 289
- Araçlar
- 7
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 4 Ağu 2026
- Lisans
- MIT
Markmap MCP nedir?
Markdown taslaklarını, yapay zeka istemcilerinin kaydedip önizleyebileceği HTML, PNG, JPG veya SVG formatlarında etkileşimli zihin haritalarına dönüştürür. 7 araç sunar; örneğin markdown, format, filename.
Özet, projenin README dosyasından oluşturuldu
Markmap MCP sunucusu hakkında
Bu server, Claude Desktop veya Cursor gibi yapay zeka istemcilerini kullanan geliştiricilerin Markdown taslaklarını görsel diyagramlara dönüştürmesini sağlar. Başlıkları ve iç içe geçmiş listeleri etkileşimli zihin haritalarına dönüştürerek, kullanıcıların karmaşık yapıları HTML, PNG, JPG veya SVG formatlarında görselleştirmesine yardımcı olur. Tüm süreç makinenizde yerel olarak çalışır ve herhangi bir üçüncü taraf API anahtarı gerektirmeden gizlilik sağlar.
Kullanıcılar, dosya oluşturmak için markdown_to_mindmap veya son çıktıları görüntülemek için list_mindmaps gibi araçları kullanarak server ile etkileşime girebilirler. PNG veya SVG gibi görsel dışa aktarımlara ihtiyaç duyduğunuzda, server dönüştürme işlemini sunucu tarafında gerçekleştirmek için Playwright ve Chromium kullanır. Server'ın veriyi nasıl döndüreceğini dosya yolları, satır içi (inline) HTML veya base64 görsel içeriği arasında seçim yaparak yapılandırabilir, hatta CDN bağımlılıklarını önlemek için varlıkları satır içine alarak çevrimdışı çalışacak şekilde ayarlayabilirsiniz.
Neler yapabilirsiniz
- 1Tasarım dokümantasyonunu görselleştirinDaha kolay kavranabilmesi için karmaşık bir tasarım dokümanını yapılandırılmış bir zihin haritasına dönüştürün.
- 2Sohbete hazır görseller oluşturunYapay zekanın sohbet içinde doğrudan bir görsel önizlemesi sunabilmesi için bir taslağın PNG versiyonunu oluşturun.
- 3Mevcut markdown dosyalarını dönüştürünYerel bir markdown dosyasını dosya yolunu kullanarak etkileşimli bir HTML zihin haritasına dönüştürün.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Markmap MCP araçları 7
README dosyasından algılandımarkdownformatfilenameopenlimitalltopic
| markdown | — | |
| format | — | |
| filename | — | |
| open | — | |
| limit | — | |
| all | — | |
| topic | — |
Yapılandırma
MARKMAP_DIRMARKMAP_OPENMARKMAP_RETURN_MODE
| Ad | Açıklama | Sunucu |
|---|---|---|
| MARKMAP_DIR | — | |
| MARKMAP_OPEN | — | |
| MARKMAP_RETURN_MODE | — |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirjinzcdev/markmap-mcp-server is public and reachablegithub.com/jinzcdev/markmap-mcp-server ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-08-04github.com/jinzcdev/markmap-mcp-server ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişNo tool named like delete, drop or execGeçti
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
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 soruları
Markmap MCP hangi araçları sunar?
7 araç sunar; bunlar arasında markdown, format, filename, open, limit yer alır.
Markmap MCP server bir API anahtarına ihtiyaç duyar mı?
Hayır. Dönüştürme işlemi tamamen yerel olarak çalışır, bu nedenle üçüncü taraf API anahtarlarına gerek yoktur.
Hangi görsel formatlarını dışa aktarabilir?
Sunucu üzerinde Playwright kullanarak PNG, JPG veya SVG formatlarında dışa aktarım yapar; ayrıca HTML görüntüleyici de dışa aktarma butonları sunar.
Bu MCP server için Node.js gereksinimleri nelerdir?
Node.js v20 veya üzeri ile sunucu tarafında görsel dışa aktarımı gerçekleştirmek için Chromium destekli Playwright gereklidir.
Oluşturulan zihin haritası dosyaları nereye kaydedilir?
Varsayılan olarak ~/.markmap-mcp dizinine kaydedilir; bu dizin --output veya MARKMAP_DIR parametreleri ile yapılandırılabilir.