Mindmap MCP Server

Converta conteúdo Markdown em mapas mentais interativos.

GitHub
239
Experimente este MCPPatrocinado

Documentação

Servidor MCP de Mindmap

mindmap_mcp

Um servidor Model Context Protocol (MCP) para converter conteúdo Markdown em mapas mentais interativos.

Instalação

pip install mindmap-mcp-server

Ou usando uvx:

uvx mindmap-mcp-server

Ou usando docker, de forma mais segura e fácil.

Atenção

Três métodos de instalação foram testados com sucesso no macOS e Linux.

Para usuários do Windows que enfrentam problemas com npx para este MCP, considere usar o método Docker. Alternativamente, se você usa o Visual Studio Code, a extensão "Markmap" oferece uma solução potencialmente mais simples do que navegar por ferramentas de linha de comando.

Se você estiver enfrentando problemas não resolvidos, você pode usar meu prompt de sistema recente como um Assistente de Mindmap em vez de usar este servidor MCP.

Usando meu prompt de sistema em vez de usar este servidor MCP 
You are a specialized assistant that generates HTML code for interactive markdown-based mind maps (markmaps). When a user sends you content, respond with a complete HTML document that displays their content as a markmap visualization.
If artifact tool is turned on, you can use the artifact.

Follow these requirements:
1. Use the markmap-autoloader library (version 0.18 or latest stable version)
2. Format the HTML exactly according to the template below
3. Replace the demo content in the template with the user's content, preserving their hierarchical structure
4. Maintain the markmap configuration options (maxWidth: 300, colorFreezeLevel: 2)
5. If the user doesn't provide markdown formatting (# for headings), format their content appropriately with main topics using # and subtopics using ##

Template to follow:

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Markmap</title>
    <style>
      svg.markmap {
        width: 100%;
        height: 100vh;
      }
    </style>
    <script src="https://cdn.jsdelivr.net/npm/markmap-autoloader@0.18"></script>
  </head>
  <body>
    <div class="markmap">
      <script type="text/template">
        ---
        markmap:
          maxWidth: 300
          colorFreezeLevel: 2
        ---

        # markmap

        ## Links

        - <https://markmap.js.org/>
        - [GitHub](https://github.com/markmap/markmap)

        ## Related

        - [coc-markmap](https://github.com/markmap/coc-markmap)
        - [gatsby-remark-markmap](https://github.com/markmap/gatsby-remark-markmap)

        ## Features

        - links
        - **inline** ~~text~~ *styles*
        - multiline
          text
        - `inline code`
        - Katex - $x = {-b \pm \sqrt{b^2-4ac} \over 2a}$
        - This is a very very very very very very very very very very very very very very very long line.
      </script>
    </div>
  </body>
</html>

Opções de visualização: (Se fórmulas ou símbolos não forem exibidos corretamente, baixe o arquivo HTML e abra-o em um navegador.)

  1. Visualize o mapa mental em artefatos (se disponível): system_prompt_artifact

  2. Renderize o arquivo HTML como um mapa mental: system_prompt_render

Pré-requisitos

Este pacote requer que o Node.js esteja instalado ao usar o comando python ou uvx para executar o servidor.

Uso

Com o Claude Desktop ou outros clientes MCP

Adicione este servidor ao seu claude_desktop_config.json:

usando `uvx`: 
{
  "mcpServers": {
    "mindmap": {
      "command": "uvx",
      "args": ["mindmap-mcp-server", "--return-type", "html"]
    }
  }
}

ou

recomendado:

{
  "mcpServers": {
    "mindmap": {
      "command": "uvx",
      "args": ["mindmap-mcp-server", "--return-type", "filePath"]
    }
  }
}

usamos --return-type para especificar o tipo de retorno do conteúdo do mapa mental; você pode escolher html ou filePath de acordo com suas necessidades.
html retornará todo o conteúdo HTML do mapa mental, que você pode visualizar no artefato do seu cliente de IA;

return_html_content

html_preview

filePath salvará o mapa mental em um arquivo e retornará o caminho do arquivo, que você pode abrir no seu navegador. Isso pode economizar seus tokens!

generate_file

file_to_open

usando `python`:

Usando um arquivo Python específico neste repositório:

{
  "mcpServers": {
    "mindmap": {
      "command": "python",
      "args": ["/path/to/your/mindmap_mcp_server/server.py", "--return-type", "html"]
    }
  }
}

ou

{
  "mcpServers": {
    "mindmap": {
      "command": "python",
      "args": ["/path/to/your/mindmap_mcp_server/server.py", "--return-type", "filePath"]
    }
  }
}

usamos --return-type para especificar o tipo de retorno do conteúdo do mapa mental; você pode escolher html ou filePath de acordo com suas necessidades. veja usando uvx\ para mais detalhes.

usando `docker`:

Primeiro, você baixa a imagem:

docker pull ychen94/mindmap-converter-mcp

Segundo, configure o servidor:

{
  "mcpServers": {
    "mindmap-converter": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-v", "/path/to/output/folder:/output", "ychen94/mindmap-converter-mcp:latest"]
    }
  }
}

⚠️ Substitua /path/to/output/folder por um caminho real no seu sistema onde você deseja salvar os mapas mentais, como /Users/username/Downloads no macOS ou C:\\Users\\username\\Downloads no Windows.

Ferramentas fornecidas no contêiner Docker O servidor fornece as seguintes ferramentas MCP:

  1. markdown-to-mindmap-content
    Converte Markdown em um mapa mental HTML e retorna todo o conteúdo HTML.
    Você não usa os argumentos: -v e /path/to/output/folder:/output no comando docker.
    Parâmetros:
    • markdown (string, obrigatório): O conteúdo Markdown a ser convertido
    • toolbar (booleano, opcional): Se deve mostrar a barra de ferramentas (padrão: true)
    Melhor para: Mapas mentais simples onde o tamanho do conteúdo HTML não é uma preocupação. E você pode usar artefato no seu cliente de IA para visualizar o mapa mental.
  2. markdown-to-mindmap-file
    Converte Markdown em um mapa mental HTML e o salva em um arquivo no diretório montado.
    Parâmetros:
    • markdown (string, obrigatório): O conteúdo Markdown a ser convertido
    • filename (string, opcional): Nome de arquivo personalizado (padrão: nome de timestamp gerado automaticamente)
    • toolbar (booleano, opcional): Se deve mostrar a barra de ferramentas (padrão: true)
    Melhor para: Mapas mentais complexos ou quando você deseja economizar os tokens para uso posterior.
    você pode abrir o arquivo HTML no seu navegador para visualizar o mapa mental. Você também pode usar o iterm-mcp-server ou outros servidores MCP de terminais para abrir o arquivo no seu navegador sem interromper seu fluxo de trabalho.

Solução de problemas

Arquivo não encontrado
Se o seu arquivo de mapa mental não estiver acessível:
1 Verifique se você montou corretamente um volume no contêiner Docker
2 Garanta que o formato do caminho esteja correto para o seu sistema operacional
3 Certifique-se de que o Docker tenha permissão para acessar o diretório

Comando Docker não encontrado
1 Verifique se o Docker está instalado e no seu PATH
2 Tente usar o caminho absoluto para o Docker

Servidor não aparecendo no Claude
1 Reinicie o Claude for Desktop após alterações de configuração
2 Verifique os logs do Claude para erros de conexão
3 Verifique se o Docker está em execução

Uso Avançado
Usando com outros clientes MCP
Este servidor funciona com qualquer cliente compatível com MCP, não apenas com o Claude for Desktop. O servidor implementa a especificação do Model Context Protocol (MCP) versão 1.0.

Recursos

Este servidor fornece uma ferramenta para converter conteúdo Markdown em mapas mentais usando a biblioteca markmap-cli:

  • Converter Markdown em HTML de mapa mental interativo
  • Opção para criar mapas mentais que funcionam offline
  • Opção para ocultar a barra de ferramentas
  • Retornar conteúdo HTML ou caminho de arquivo

Exemplo

No Claude, você pode perguntar:

"crie um mapa mental para o seguinte código markdown, usando uma ferramenta de mapa mental:

# Project Planning
## Research
### Market Analysis
### Competitor Review
## Design
### Wireframes
### Mockups
## Development
### Frontend
### Backend
## Testing
### Unit Tests
### User Testing

"

se você quiser salvar o mapa mental em um arquivo e depois abri-lo no seu navegador usando o servidor MCP do iTerm:

"crie um mapa mental para o seguinte input_code markdown usando uma ferramenta de mapa mental, depois disso, use o iterm para abrir o arquivo html gerado. input_code:

markdown content

"

"Pense no processo de colocar um elefante em uma geladeira e forneça um mapa mental. Abra-o com um terminal."

veja o resultado

aiworkflow

mindmapinbrowser

e muito mais

Licença

Este projeto está licenciado sob a Licença MIT. Para mais detalhes, consulte o arquivo LICENSE em este repositório do projeto

Se este projeto for útil para você, considere dar uma Estrela ⭐️

O avanço da tecnologia deve beneficiar todos os indivíduos, em vez de explorar a população em geral.