Markmap MCP Server

Vytvořeno: 7.7.2026 | Aktualizováno: 07.07.2026 21:20

Markmap MCP Server je server pro Model Context Protocol (MCP), který převádí Markdown na interaktivní myšlenkové mapy. Staví nad projektem markmap a hodí se tam, kde má AI agent z osnovy, poznámek nebo technické dokumentace rychle vytvořit vizuální HTML přehled.

Co umí

převod Markdownu na interaktivní mind mapu v HTML,
zoomování a rozbalování/sbalování uzlů přes markmap toolbar,
export z otevřené HTML stránky do PNG, JPG nebo SVG,
zkopírování původního Markdownu z vygenerované stránky,
volitelné automatické otevření výsledku v prohlížeči.

Důležité je, že MCP nástroj nevrací přímo PNG/SVG soubor. Vygeneruje HTML soubor a vrátí cestu k němu. Export do obrázků se řeší až v prohlížeči přes tlačítka ve vygenerované stránce.

Instalace

Projekt vyžaduje Node.js 20 nebo novější.

Instalace přes Smithery pro Claude Desktop:

npx -y @smithery/cli install @jinzcdev/markmap-mcp-server --client claude

Ruční instalace z npm balíčku:

npm install @jinzcdev/markmap-mcp-server -g
 
# základní spuštění
npx -y @jinzcdev/markmap-mcp-server
 
# explicitní výstupní adresář
npx -y @jinzcdev/markmap-mcp-server --output /path/to/output/directory

Lokální spuštění ze zdrojových kódů:

git clone https://github.com/jinzcdev/markmap-mcp-server.git
cd markmap-mcp-server
npm install
npm run build
node build/index.js

Konfigurace MCP klienta

Server běží přes stdio. Typická konfigurace MCP klienta:

{
  "mcpServers": {
    "markmap": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@jinzcdev/markmap-mcp-server"],
      "env": {
        "MARKMAP_DIR": "/path/to/output/directory"
      }
    }
  }
}

Výstupní adresář lze nastavit dvěma způsoby:

argumentem --output / -o,
proměnnou prostředí MARKMAP_DIR.

Pokud jsou nastavené obě hodnoty, argument --output má přednost. Když není nastavené nic, server použije systémový dočasný adresář a v něm složku markmap.

Dostupný MCP nástroj

V aktuálním kódu je registrovaný nástroj:

markdown_to_mindmap

README má sekci pojmenovanou markdown-to-mindmap, ale implementace v src/mcp/tools/markmap-tools.ts registruje název s podtržítky. Pro reálné volání přes MCP je rozhodující název registrovaný v kódu.

Parametry:

markdown – povinný řetězec s Markdown obsahem,
open – volitelný boolean; při true se server pokusí otevřít výsledek v prohlížeči.

Příklad vstupu:

{
  "markdown": "# Projekt\n\n- Cíl\n- Kroky\n  - Návrh\n  - Implementace\n  - Ověření",
  "open": false
}

Návratová hodnota je textový MCP výstup s JSON obsahem, kde je cesta k vytvořenému HTML souboru:

{
  "filePath": "/tmp/markmap/markmap-1780000000000.html"
}

Jak funguje uvnitř

Server při spuštění vytvoří MCP server přes @modelcontextprotocol/sdk a připojí ho na StdioServerTransport. Při volání nástroje se z Markdownu vytvoří HTML pomocí markmap-lib a markmap-render.

Do výsledného HTML se navíc vkládá:

markmap toolbar pro interaktivní práci s mapou,
knihovna html-to-image pro export do PNG/JPG/SVG,
skrytý textarea s původním Markdownem kvůli tlačítku Copy Markdown,
spodní exportní lišta s tlačítky Export PNG, Export JPG, Export SVG a Copy Markdown.

Praktické použití

Markmap MCP Server dává smysl hlavně jako pomocný nástroj pro AI agenty, kteří mají z textového obsahu vytvořit vizuální strukturu:

přehled architektury projektu,
osnovu článku nebo dokumentace,
rozpad úkolů a podúkolů,
vizualizaci poznámek ze schůzky,
rychlé vysvětlení hierarchie tématu.

Typický workflow je jednoduchý: agent připraví Markdown s nadpisy a odrážkami, zavolá markdown_to_mindmap a uživateli předá cestu k HTML souboru.

Poznámky a omezení

Výstupem je lokální HTML soubor. MCP klient nebo uživatel musí mít k dané cestě přístup.
Volba open: true je vhodná spíš pro desktopové prostředí. Na serveru nebo v headless prostředí je bezpečnější nechat open na false.
Export do PNG/JPG/SVG probíhá až ve vygenerované HTML stránce, ne jako samostatný MCP výstup.
V package.json je verze balíčku 0.1.1, zatímco metadata MCP serveru v src/index.ts uvádí 0.1.0.
Původní Markdown je uložený přímo ve výsledném HTML souboru. U citlivých dat je potřeba počítat s tím, že budou součástí lokálního výstupu.

Ověření

Při kontrole repozitáře prošlo sestavení projektu i testy:

npm run build
npm test

Testovací sada v době kontroly obsahovala jeden Vitest test, který ověřuje vytvoření HTML z ukázkového Markdownu přes markmap-lib a markmap-render.

Obsah