Servidor MCP de mapas mentales

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

Instalación

pip install mindmap-mcp-server

O usando uvx :

uvx mindmap-mcp-server

O usar docker de forma más segura y sencilla.

Related MCP server: MarkItDown MCP Server

Atención

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

Si tiene problemas con npx para este MCP, considere usar el método Docker. Si usa Visual Studio Code, la extensión "Markmap" ofrece una solución potencialmente más sencilla que usar herramientas de línea de comandos.

Prerrequisitos

Este paquete requiere que Node.js esté instalado cuando se utiliza 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 :

{
  "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 puedes previsualizar en el artefacto de tu cliente de IA;

filePath guardará el mapa mental en un archivo y devolverá la ruta, que podrás abrir en tu navegador. ¡Puede guardar tus tokens !

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 el uso de `uvx` para obtener más detalles.

Primero, extraes la imagen:

docker pull ychen94/mindmap-converter-mcp

En segundo lugar, 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 desea guardar 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 a contenido de mapa mental
   Convierte Markdown en un mapa mental HTML y devuelve el contenido HTML completo.
   No utilice los argumentos: -v y /path/to/output/folder:/output en el comando docker .
   Parámetros :
   • markdown (cadena, obligatoria): el contenido de Markdown que se convertirá
   • barra de herramientas (booleano, opcional): si se debe mostrar la barra de herramientas (valor predeterminado: verdadero)
   Ideal para : Mapas mentales sencillos donde el tamaño del contenido HTML no es un problema. Puedes usar Artifact en tu cliente de IA para previsualizar el mapa mental.

2. Markdown a archivo de mapa mental
   Convierte Markdown en un mapa mental HTML y lo guarda en un archivo en el directorio montado.
   Parámetros :
   • markdown (cadena, obligatoria): el contenido de Markdown que se convertirá
   • nombre de archivo (cadena, opcional): nombre de archivo personalizado (predeterminado: nombre de marca de tiempo generado automáticamente)
   • barra de herramientas (booleano, opcional): si se debe mostrar la barra de herramientas (valor predeterminado: verdadero)
   Ideal para : mapas mentales complejos o cuando desea guardar los tokens para usarlos más adelante.
   Puede abrir el archivo HTML en su navegador para ver el mapa mental. También puede usar 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 Comprueba que has 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 utilizar la ruta absoluta a Docker

El servidor no aparece en Claude
1 Reiniciar Claude for Desktop después de los cambios de configuración
2 Verifique los registros de Claude para detectar errores de conexión
3 Verifique que Docker se esté ejecutando

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

Características

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

• Convertir Markdown en un mapa mental interactivo HTML

• Opción para crear mapas mentales sin conexión

• Opción para ocultar la barra de herramientas

• Devuelve el contenido HTML o la ruta del archivo

Ejemplo

En Claude puedes preguntar:

" proporcione un mapa mental para el siguiente código Markdown, utilizando 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 iTerm MCP:

" Proporcione un mapa mental para el siguiente input_code de Markdown usando una herramienta de mapas mentales, luego use iterm para abrir el archivo html generado. input_code:

markdown content

"

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

y más

Licencia

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

Si este proyecto te resulta útil, considera darle una Estrella ⭐️

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