Mindmap MCP Server

Convierte contenido Markdown en mapas mentales interactivos.

GitHub
239
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Mapas Mentales

mindmap_mcp

Un servidor de Protocolo de Contexto de Modelos (MCP) para convertir contenido Markdown en mapas mentales interactivos.

Instalación

pip install mindmap-mcp-server

O usando uvx:

uvx mindmap-mcp-server

O usando docker, más seguro y fácil.

Atención

Se han probado con éxito tres métodos de instalación en macOS y Linux.

Para usuarios de Windows que experimenten problemas con npx para este MCP, considere usar el método Docker. Alternativamente, si usa Visual Studio Code, la extensión "Markmap" ofrece una solución potencialmente más simple que navegar por herramientas de línea de comandos.

Si está experimentando problemas no resueltos, puede usar mi prompt de sistema reciente como Asistente de Mapas Mentales en lugar de usar este servidor MCP.

Usando mi prompt de sistema en lugar 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>

Opciones de visualización: (Si las fórmulas o símbolos no se muestran correctamente, descargue el archivo HTML y ábralo en un navegador.)

  1. Vea el mapa mental en artefactos (si está disponible): system_prompt_artifact

  2. Renderice el archivo HTML como un mapa mental: system_prompt_render

Requisitos previos

Este paquete requiere que Node.js esté instalado cuando se usa el comando python o uvx para ejecutar el servidor.

Uso

Con Claude Desktop u otros clientes MCP

Agregue este servidor a su claude_desktop_config.json:

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

o

recomendado:

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

usamos --return-type para especificar el tipo de retorno del contenido del mapa mental, puede elegir html o filePath según sus necesidades.
html devolverá todo el contenido HTML del mapa mental, que puede previsualizar en el artefacto de su cliente de IA;

return_html_content

html_preview

filePath guardará el mapa mental en un archivo y devolverá la ruta del archivo, que puede abrir en su navegador. ¡Puede ahorrar sus tokens!

generate_file

file_to_open

usando `python`:

Usando un archivo Python específico en este repositorio:

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

o

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

usamos --return-type para especificar el tipo de retorno del contenido del mapa mental, puede elegir html o filePath según sus necesidades. consulte usando uvx\ para más detalles.

usando `docker`:

Primero, extraiga la imagen:

docker pull ychen94/mindmap-converter-mcp

Segundo, configure el servidor:

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

⚠️ Reemplace /path/to/output/folder con una ruta real en su sistema donde desee guardar los mapas mentales, como /Users/username/Downloads en macOS o C:\\Users\\username\\Downloads en Windows.

Herramientas proporcionadas en el contenedor Docker El servidor proporciona las siguientes herramientas MCP:

  1. markdown-to-mindmap-content
    Convierte Markdown a un mapa mental HTML y devuelve todo el contenido HTML.
    No use los argumentos: -v y /path/to/output/folder:/output en el comando docker.
    Parámetros:
    • markdown (cadena, obligatorio): El contenido Markdown a convertir
    • toolbar (booleano, opcional): Si mostrar la barra de herramientas (predeterminado: true)
    Mejor para: Mapas mentales simples donde el tamaño del contenido HTML no es una preocupación. Y puede usar artefactos en su cliente de IA para previsualizar el mapa mental.
  2. markdown-to-mindmap-file
    Convierte Markdown a un mapa mental HTML y lo guarda en un archivo en el directorio montado.
    Parámetros:
    • markdown (cadena, obligatorio): El contenido Markdown a convertir
    • filename (cadena, opcional): Nombre de archivo personalizado (predeterminado: nombre de marca de tiempo generado automáticamente)
    • toolbar (booleano, opcional): Si mostrar la barra de herramientas (predeterminado: true)
    Mejor para: Mapas mentales complejos o cuando desea ahorrar los tokens para uso posterior.
    puede abrir el archivo HTML en su navegador para ver el mapa mental. También puede usar el iterm-mcp-server u otros servidores MCP de terminales para abrir el archivo en su navegador sin interrumpir su flujo de trabajo.

Solución de problemas

Archivo no encontrado
Si su archivo de mapa mental no es accesible:
1 Verifique que haya montado correctamente un volumen en el contenedor Docker
2 Asegúrese de que el formato de la ruta sea correcto para su sistema operativo
3 Asegúrese de que Docker tenga permiso para acceder al directorio

Comando Docker no encontrado
1 Verifique que Docker esté instalado y en su PATH
2 Intente usar la ruta absoluta a Docker

Servidor no aparece en Claude
1 Reinicie Claude for Desktop después de los cambios de configuración
2 Revise los registros de Claude para detectar errores de conexión
3 Verifique que Docker esté ejecutándose

Uso Avanzado
Uso con otros clientes MCP
Este servidor funciona con cualquier cliente compatible con MCP, no solo Claude for Desktop. El servidor implementa la especificación del Protocolo de Contexto de Modelos (MCP) versión 1.0.

Características

Este servidor proporciona una herramienta para convertir contenido Markdown a mapas mentales usando la biblioteca markmap-cli:

  • Convertir Markdown a HTML de mapa mental interactivo
  • Opción para crear mapas mentales que funcionan sin conexión
  • Opción para ocultar la barra de herramientas
  • Devolver contenido HTML o ruta de archivo

Ejemplo

En Claude, puede preguntar:

"dame un mapa mental para el siguiente código markdown, usando una herramienta de mapas mentales:

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

"

si desea guardar el mapa mental en un archivo y luego abrirlo en su navegador usando el servidor MCP de iTerm:

"dame un mapa mental para el siguiente input_code markdown usando una herramienta de mapas mentales, después de eso, usa iterm para abrir el archivo html generado. input_code:

markdown content

"

"Piensa en el proceso de meter un elefante en un refrigerador y proporciona un mapa mental. Ábrelo con una terminal."

ver el resultado

aiworkflow

mindmapinbrowser

y más

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Para más detalles, consulte el archivo LICENSE en el repositorio de este proyecto

Si este proyecto le resulta útil, considere darle una Estrella ⭐️

El avance de la tecnología debería beneficiar a todos los individuos en lugar de explotar a la población en general.