Hosting

Local stdio process

Transport

stdio

Endpoint

Local process; no hosted endpoint documented

Authentication

No credentials were configured; the tested read-only tool “list_mindmaps” succeeded in an isolated environment. Other tools may have additional requirements.

Requirements

• Node.js 18+
• The npm package repository matched the repository linked from the public profile.

Setup steps

1. npx -y @jinzcdev/markmap-mcp-server@0.2.0

Four documented tools match four stored rows.

• markdown_to_mindmap

  Convert structured Markdown (headings # and nested lists -) into an interactive mind map HTML file, with optional server-side PNG/JPG/SVG export. Use when the user wants a visual mind map/outline of structured content (architecture, plans, notes, hierarchies), or asks to visualize / mindmap / diagram. Do not use for flat unstructured text (restructure first), or to list/read existing outputs (use list_mindmaps / get_mindmap). Behavior: - WRITES files under the configured output dir. HTML is always written; image formats write an extra file. Reusing filename overwrites. - html is fast (<1s). png/svg/jpg launch headless Chromium via Playwright (5–15s; requires: npm install playwright && npx playwright install chromium). - Local only — no external APIs or third-party keys. Open mode=never: The server never opens the browser. - Offline=false (server config). Response: - JSON {"htmlFilePath":"<path>","filePath":"<path>"} — htmlFilePath is always the HTML source; filePath is the primary a

  Parameters: markdown, inputPath, format, filename
  01
• list_mindmaps

  List markmap* files (html/png/jpg/jpeg/svg) in the output directory, newest first. Read-only — no side effects. Missing/empty dirs return {"files":[]}. Returns: {"outputDir","files":[{"name","filePath","size","mtimeMs","mtime"}]} (mtime is ISO 8601). Use before get_mindmap to discover paths, or before cleanup_mindmaps to preview targets. Not for generating new mind maps (use markdown_to_mindmap).

  Parameters: limit
  02
• get_mindmap

  Retrieve a generated mind map file by absolute path. Read-only — no side effects. Only paths inside the configured output directory are allowed (path traversal denied). Returns JSON {"filePath","mimeType","size"}. For text/html or image/svg+xml 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 the agent needs pixels. On error: isError:true with {"error":"Failed to retrieve mind map","message"}. Use list_mindmaps first to obtain a valid filePath. Prefer this over regenerating when the file already exists.

  Parameters: filePath
  03
• cleanup_mindmaps

  Permanently delete markmap* files from the output directory. DESTRUCTIVE and irreversible when dryRun is false. dryRun defaults to false — omitting it WILL delete. Always call once with dryRun=true to preview, then again with dryRun=false to commit. Prefer list_mindmaps beforehand. Returns {"deleted":["<path>",...],"kept":<n>}; dryRun responses also include dryRun:true and do not delete. Use instead of manual file deletion when pruning old generated mind maps.

  Parameters: maxAgeDays, all, dryRun
  04

• Runtime verification covered one read-only tool call (list_mindmaps); other listed tools were not individually exercised.

• MCP.Directory public profile

  Name, description, publisher identifier, categories, transport, tool inventory, and install configuration.

• Linked publisher repository

  Repository URL linked from the public profile; npm package repository metadata matched this GitHub repository.

• npm registry metadata

  Published package version 0.2.0 checked before launch. Registry repository: git+https://github.com/jinzcdev/markmap-mcp-server.git.

• maintainer repository documentation

  Maintainer README lists four tools: markdown_to_mindmap, list_mindmaps, get_mindmap, cleanup_mindmaps; also includes a prompt that is not an MCP tool.

Documentation checked 2026-10-28T00:00:00Z. Connection has not been runtime tested.