Markmap MCP 서버는 모델 컨텍스트 프로토콜(MCP)을 기반으로 합니다. 마크맵을 이용해 마크다운을 인터랙티브 마인드맵으로 변환하며, 에이전트 친화적 전달을 위해 서버에서 선택적으로 PNG / JPG / SVG 파일을 내보낼 수 있습니다. 생성은 로컬에서 실행되며 서드파티 API 키가 필요하지 않습니다.

특징

• 마크다운 → 마인드맵: 마크다운(제목 + 중첩된 리스트)을 인터랙티브 HTML 마인드맵으로 변환
• 에이전트 친화적 반환: 파일 경로, 인라인 HTML 및/또는 이미지 콘텐츠를 반환(시작 시 설정됨)
• 서버 측 내보내기: Playwright를 통해 채팅/인라인 미리보기를 위해 PNG / JPG / SVG 내보내기
• 브라우저 미리보기: 설정 가능한 열린 동작 — 항상, 절대 또는 에이전트가 결정하는 (시작 설정)
• 브라우저 내보내기 툴바: HTML을 볼 때는 PNG/JPG/SVG 내보내기도 하거나 페이지 UI에서 Markdown 복사하기도 합니다
• 오프라인 HTML: 시작 --offline 인라인 에셋을 통해 CDN 접근 없이도 페이지가 작동하도록
• 파일 워크플로우: inputPath에서 읽기, 최근 출력 목록, 오래된 파일 정리
• 개인정보 우선: 완전 로컬 전환; 클라우드 마인드맵 API 없음

선수 조건

1. Node.js v20 이상
2. **서버 측 이미지 내보내기 (format: png|jpg|svg): Playwright와 Chromium 설치

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 --offline inlines 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

1. Node.js v20 or above
2. 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": {