Markmap MCP Server MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Ferramenta única de markdown para mapa mental - insira o Markdown e obtenha uma árvore renderizada
Saída interativa: zoom, panorâmica, expansão/recolhimento de nós
Exporte para PNG/JPG/SVG da página renderizada
Abertura automática no navegador padrão (opcional)
MARKMAP_DIR env var para controlar onde as saídas chegam

Demo ao vivo

Como fica na prática

markmap-mcp-server.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

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

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.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 usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

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

Clique no ícone MCP Servers na barra lateral do Cline, depois "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"
      }
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

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

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "markmap-mcp-server": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@jinzcdev/markmap-mcp-server"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Markmap MCP Server

Transforme anotações de reuniões em um mapa mental para compartilhamento rápido

👤 PMs e líderes de equipe executando sincronizações com muitas anotações ⏱ ~10 min beginner

Quando usar: Depois de uma reunião, quando uma lista simples esconde o formato da discussão.

Pré-requisitos

Nó 18+ — instalação nvm 18

Fluxo

Faça com que o agente rascunhe o Markdown

Resuma a reunião de planejamento de hoje como um esboço de Markdown aninhado com temas de nível superior.✓ Copiado

→ O esboço tem de 3 a 5 temas principais, subpontos aninhados
Renderizar

Execute markdown-to-mindmap nesse esboço, aberto no navegador.✓ Copiado

→ O mapa mental interativo é aberto; nós colapsam/expandem
Exportar

Exporte o mapa para SVG e solte o arquivo no documento da equipe.✓ Copiado

→ SVG salvo em MARKMAP_DIR

Resultado: Um mapa mental compartilhável que codifica o formato da reunião, não apenas suas palavras.

Armadilhas

Contorno muito superficial – tudo se torna um nó de nível superior — Aninhamento forçado: peça temas → subpontos → fatos de apoio

Combine com: filesystem

Construa um mapa de estudo a partir de um capítulo de livro didático

👤 Estudantes e aprendizes ao longo da vida ⏱ ~20 min beginner

Quando usar: Você leu um capítulo e deseja um visual de imagem única para revisar antes de um exame.

Fluxo

Resuma o capítulo

Resuma o capítulo 4 de <book> como um esboço hierárquico do Markdown.✓ Copiado

→ Limpar árvore de tópicos
Renderizar e exportar

Produza um mapa mental e salve como PNG em ~/study/.✓ Copiado

→ Arquivo PNG pronto para revisão

Resultado: Um auxílio de estudo visual que leva segundos para ser digitalizado.

Combine com: paper-fetch-skill

Elabore um mapa de arquitetura informal antes de escrever um diagrama completo

👤 Engenheiros desenhando antes de se comprometerem com draw.io/Figma ⏱ ~15 min intermediate

Quando usar: Você quer um diagrama de 'talk-track' de 2 minutos, não um documento de arquitetura polido.

Fluxo

Listar serviços no Markdown

Descreva os serviços neste repositório como uma árvore Markdown aninhada agrupada por domínio.✓ Copiado

→ O esboço agrupado reflete a estrutura da base de código
Renderizar

Transforme-o em um mapa mental e exporte SVG.✓ Copiado

→ SVG você pode inserir o documento de design

Resultado: Um diagrama de acompanhamento em minutos; atualize para um diagrama de arquitetura real posteriormente somente se necessário.

Armadilhas

Tratando-o como o artefato final — Use-o como uma ferramenta de pensamento; substitua por um diagrama formal antes de publicar

Combine com: mermaid-skill

Combinações

Combine com outros MCPs para 10× de alavancagem

markmap-mcp-server + filesystem

Leia um documento longo, resuma no esboço do Markdown, renderize como mapa mental

Leia ./notes/long-doc.md, produza um esboço aninhado e depois renderize-o como um mapa mental.✓ Copiado

markmap-mcp-server + mermaid-skill

Escolha o visual certo – sereia para fluxos, mapa de marcação para hierarquias

Decida se este é um fluxo (sereia) ou uma hierarquia (markmap) e renderize de acordo.✓ Copiado

markmap-mcp-server + paper-fetch-skill

Busque o resumo/seções de um artigo, mapeie a estrutura do argumento

Pegue o artigo, extraia os títulos das seções e os pontos-chave, apresente o argumento como um mapa mental.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
markdown-to-mindmap	markdown: str, open?: bool	Converta um esboço de Markdown aninhado em um mapa mental interativo	0

Custo e limites

O que custa rodar

Cota de API: Nenhum — renderiza localmente
Tokens por chamada: Pequeno: tamanho do contorno
Monetário: Livre
Dica: Mantenha os contornos em aproximadamente 100 nós para facilitar a leitura; mapas maiores demoram para deslocar/exportar.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Sem credenciais – renderização offline

Saída de dados: Nenhuma saída de rede. Fontes e JS agrupados localmente.

Se você definir MARKMAP_DIR dentro de um repositório git, os arquivos HTML/PNG gerados podem acabar confirmados; adicione o diretório de saída a .gitignore.

Solução de problemas

Erros comuns e correções

O navegador não abriu

Defina open=false e abra o caminho HTML retornado manualmente; confirme se um navegador padrão está registrado.

Verificar: open $(returned_path) on macOS

O PNG exportado está em branco

Aguarde um segundo para que o mapa seja totalmente renderizado antes de exportar. Aumente o atraso na configuração ou execute a exportação duas vezes.

Verificar: Open the HTML in a browser and check it renders before export

Permissão negada para gravação em MARKMAP_DIR

Aponte MARKMAP_DIR para um caminho gravável em seu diretório inicial.

Verificar: touch $MARKMAP_DIR/.probe && rm $MARKMAP_DIR/.probe

Alternativas

Markmap MCP Server vs. outros

Alternativa	Quando usar	Troca
mermaid-skill	Seus dados são um fluxo ou sequência, não uma hierarquia	Paradigma de diagrama diferente
excalidraw-skill	Você quer visuais esboçados desenhados à mão	Sem layout automático; posicionamento manual
antv-chart	Você precisa de gráficos estatísticos, não de mapas mentais	Classe de saída diferente

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills