====== Markmap MCP Server ======

//Vytvořeno: **7.7.2026** | Aktualizováno: **~~LASTMOD~~**//

[[https://github.com/jinzcdev/markmap-mcp-server|Markmap MCP Server]] je server pro [[https://modelcontextprotocol.io/introduction|Model Context Protocol (MCP)]], který převádí Markdown na interaktivní myšlenkové mapy. Staví nad projektem [[https://github.com/markmap/markmap|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 [[https://smithery.ai/server/@jinzcdev/markmap-mcp-server|Smithery]] pro Claude Desktop:

<code bash>
npx -y @smithery/cli install @jinzcdev/markmap-mcp-server --client claude
</code>

Ruční instalace z [[https://www.npmjs.com/package/@jinzcdev/markmap-mcp-server|npm balíčku]]:

<code bash>
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
</code>

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

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

===== Konfigurace MCP klienta =====

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

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

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

  * argumentem <nowiki>--output</nowiki> / ''-o'',
  * proměnnou prostředí ''MARKMAP_DIR''.

Pokud jsou nastavené obě hodnoty, argument <nowiki>--output</nowiki> 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:

<code>
markdown_to_mindmap
</code>

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:

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

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

<code json>
{
  "filePath": "/tmp/markmap/markmap-1780000000000.html"
}
</code>

===== 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:

<code bash>
npm run build
npm test
</code>

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

===== Zdroje =====

  * [[https://github.com/jinzcdev/markmap-mcp-server|jinzcdev/markmap-mcp-server – GitHub repozitář]]
  * [[https://www.npmjs.com/package/@jinzcdev/markmap-mcp-server|@jinzcdev/markmap-mcp-server – npm balíček]]
  * [[https://smithery.ai/server/@jinzcdev/markmap-mcp-server|Markmap MCP Server na Smithery]]
  * [[https://modelcontextprotocol.io/introduction|Model Context Protocol – dokumentace]]
  * [[https://github.com/markmap/markmap|markmap – GitHub projekt]]