/ 디렉터리 / 플레이그라운드 / Markmap MCP Server
● 커뮤니티 jinzcdev ⚡ 바로 사용

Markmap MCP Server

제작: jinzcdev · jinzcdev/markmap-mcp-server

이동, 축소, PNG/JPG/SVG 내보내기 등 한 번의 도구 호출을 통해 Markdown 개요를 대화형 마인드 맵으로 변환할 수 있습니다.

markmap-mcp-server는 오픈 소스 마크맵 렌더러를 MCP 도구로 래핑합니다. 중첩된 제목이나 글머리 기호 목록이 포함된 마크다운을 피드하고, 브라우저에서 열리고(자동 실행 가능) PNG/JPG/SVG로 내보내는 HTML 마인드 맵을 다시 가져옵니다. 회의 요약, 브레인스토밍 캡처, 학습 노트에 유용하며 언제든지 평평한 개요가 나무로 생각하기가 더 쉽습니다.

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

markmap-mcp-server.replay ▶ 준비됨
0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "markmap-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ],
      "env": {
        "MARKMAP_DIR": "/path/to/output"
      }
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "markmap-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ],
      "env": {
        "MARKMAP_DIR": "/path/to/output"
      }
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "markmap-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ],
      "env": {
        "MARKMAP_DIR": "/path/to/output"
      }
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "markmap-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ],
      "env": {
        "MARKMAP_DIR": "/path/to/output"
      }
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "markmap-mcp-server",
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json
{
  "context_servers": {
    "markmap-mcp-server": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@jinzcdev/markmap-mcp-server"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add markmap-mcp-server -- npx -y @jinzcdev/markmap-mcp-server

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Markmap MCP Server

빠른 공유를 위해 회의록을 마인드맵으로 전환

👤 메모가 많은 동기화를 실행하는 PM, 팀 리더 ⏱ ~10 min beginner

언제 쓸까: 회의 후 평평한 글머리 기호 목록이 토론의 형태를 가릴 때.

사전 조건
  • 노드 18+ — nvm 설치 18
흐름
  1. 상담원에게 Markdown 초안을 요청하세요.
    오늘의 계획 회의를 최상위 주제가 포함된 중첩된 Markdown 개요로 요약합니다.✓ 복사됨
    → 개요에는 3~5개의 상위 테마가 있고 하위 항목이 중첩되어 있습니다.
  2. 세우다
    해당 개요에 대해 markdown-to-mindmap을 실행하고 브라우저에서 엽니다.✓ 복사됨
    → 대화형 마인드맵이 열립니다. 노드 축소/확장
  3. 내보내다
    지도를 SVG로 내보내고 파일을 팀 문서에 놓습니다.✓ 복사됨
    → MARKMAP_DIR에 저장된 SVG

결과: 단지 말이 아닌 회의의 형태를 인코딩하는 공유 가능한 마인드 맵입니다.

함정
  • 개요가 너무 얕음 - 모든 것이 최상위 노드가 됨 — 강제 중첩: 테마 요청 → 하위 항목 → 지원 사실
함께 쓰기: filesystem

교과서 장에서 학습 지도 만들기

👤 학생과 평생학습자 ⏱ ~20 min beginner

언제 쓸까: 한 장을 읽었으며 시험 전에 검토할 수 있는 단일 이미지 시각 자료를 원합니다.

흐름
  1. 장을 요약하세요
    <book>의 4장을 계층적 Markdown 개요로 요약합니다.✓ 복사됨
    → 주제 트리 지우기
  2. 렌더링 및 내보내기
    마인드맵을 제작하고 ~/study/에 PNG로 저장합니다.✓ 복사됨
    → PNG 파일 검토 준비 완료

결과: 스캔하는 데 몇 초 밖에 걸리지 않는 시각적 학습 보조 도구입니다.

함께 쓰기: paper-fetch-skill

전체 다이어그램을 작성하기 전에 비공식 아키텍처 맵 초안 작성

👤 draw.io/figma에 참여하기 전에 스케치하는 엔지니어들 ⏱ ~15 min intermediate

언제 쓸까: 세련된 아키텍처 문서가 아닌 2분짜리 '대화 트랙' 다이어그램을 원합니다.

흐름
  1. 마크다운으로 서비스 나열
    이 저장소의 서비스를 도메인별로 그룹화된 중첩된 마크다운 트리로 간략하게 설명합니다.✓ 복사됨
    → 그룹화된 개요는 코드베이스 구조를 반영합니다.
  2. 세우다
    마인드맵으로 변환하고 SVG로 내보냅니다.✓ 복사됨
    → SVG를 디자인 문서에 넣을 수 있습니다.

결과: 몇 분 안에 대화 트랙 다이어그램을 볼 수 있습니다. 나중에 필요한 경우에만 실제 아키텍처 다이어그램으로 업그레이드하세요.

함정
  • 최종 유물로 취급 — 사고 도구로 사용하십시오. 게시하기 전에 공식 다이어그램으로 교체
함께 쓰기: mermaid-skill

조합

다른 MCP와 조합해 10배 효율

markmap-mcp-server + filesystem

긴 문서를 읽고, Markdown 개요로 요약하고, 마인드맵으로 렌더링하세요.

./notes/long-doc.md를 읽고 중첩된 개요를 생성한 다음 마인드 맵으로 렌더링합니다.✓ 복사됨
markmap-mcp-server + mermaid-skill

올바른 시각적 개체 선택 - 흐름에는 인어, 계층에는 마크맵

이것이 흐름(인어)인지 계층 구조(마크맵)인지 결정하고 그에 따라 렌더링합니다.✓ 복사됨
markmap-mcp-server + paper-fetch-skill

논문의 초록/섹션을 가져오고 인수 구조를 매핑합니다.

논문을 가져오고, 섹션 제목과 핵심 포인트를 추출하고, 논거를 마인드 맵으로 렌더링합니다.✓ 복사됨

도구

이 MCP가 노출하는 것

도구입력언제 호출비용
markdown-to-mindmap markdown: str, open?: bool 중첩된 Markdown 개요를 대화형 마인드 맵으로 변환 0

비용 및 제한

운영 비용

API 쿼터
없음 — 로컬로 렌더링
호출당 토큰
작음: 개요 크기
금액
무료
가독성을 위해 개요를 최대 100개 노드로 유지합니다. 더 큰 지도는 이동/내보내기가 느립니다.

보안

권한, 시크릿, 파급범위

자격 증명 저장: 자격 증명 없음 - 오프라인 렌더링
데이터 외부 송신: 네트워크 송신이 없습니다. 글꼴과 JS가 로컬로 번들로 제공됩니다.

문제 해결

자주 발생하는 오류와 해결

브라우저가 열리지 않았습니다

open=false로 설정하고 반환된 HTML 경로를 수동으로 엽니다. 기본 브라우저가 등록되어 있는지 확인하세요.

확인: open $(returned_path) on macOS
내보낸 PNG가 비어 있습니다.

내보내기 전에 지도가 완전히 렌더링될 때까지 잠시 기다리세요. 구성 지연을 늘리거나 내보내기를 두 번 실행하세요.

확인: Open the HTML in a browser and check it renders before export
MARKMAP_DIR에 쓰기 권한이 거부되었습니다.

홈 디렉터리의 쓰기 가능한 경로에서 MARKMAP_DIR을 지정합니다.

확인: touch $MARKMAP_DIR/.probe && rm $MARKMAP_DIR/.probe

대안

Markmap MCP Server 다른 것과 비교

대안언제 쓰나단점/장점
mermaid-skill데이터는 계층 구조가 아닌 흐름 또는 시퀀스입니다.다양한 다이어그램 패러다임
excalidraw-skill손으로 그린 ​​스케치 영상을 원합니다.자동 레이아웃이 없습니다. 수동 위치 지정
antv-chart마인드 맵이 아닌 통계 차트가 필요합니다다른 출력 클래스

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기