Markmap MCP Server

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

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.

• 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.

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

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.

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"
}

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.

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.

• 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.

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.

• jinzcdev/markmap-mcp-server – GitHub repozitář
• @jinzcdev/markmap-mcp-server – npm balíček
• Markmap MCP Server na Smithery
• Model Context Protocol – dokumentace
• markmap – GitHub projekt