markmap-http-mcp

Servidor MCP de Markmap

El servidor MCP de Markmap se basa en el Protocolo de Contexto de Modelo (MCP) y permite la conversión con un solo clic de texto Markdown a mapas mentales interactivos, construido sobre el proyecto de código abierto markmap. Los mapas mentales generados admiten operaciones interactivas enriquecidas y se pueden exportar en varios formatos de imagen.

🎉 Explora más herramientas de mapas mentales

Prueba MarkXMind: un editor en línea que crea mapas mentales complejos usando la sintaxis simple de XMindMark. Admite vista previa en tiempo real, exportación en múltiples formatos (.xmind/.svg/.png) e importación de archivos XMind existentes. Pruébalo ahora!

Características

• 🌠 De Markdown a mapa mental: Convierte texto Markdown en mapas mentales interactivos
• 🖼️ Exportación en múltiples formatos: Soporte para exportar como imágenes PNG, JPG y SVG
• 🔄 Operaciones interactivas: Soporte para zoom, expandir/contraer nodos y otras funciones interactivas
• 📋 Copiar Markdown: Copia con un clic el contenido Markdown original
• 🌐 Vista previa automática en el navegador: Opción para abrir automáticamente los mapas mentales generados en el navegador

Requisitos previos

1. Node.js (v25)

Instalación

Instalación manual

# Install from npm
npm install @isdmx/markmap-mcp-server -g

# Basic run
npx -y @isdmx/markmap-mcp-server

# Specify output directory
npx -y @isdmx/markmap-mcp-server --output /path/to/output/directory

# Or
markmap-mcp-server

Alternativamente, puedes clonar el repositorio y ejecutarlo localmente:

# Clone the repository
git clone https://github.com/isdmx/markmap-mcp-server.git

# Navigate to the project directory
cd markmap-mcp-server

# Build project
npm install && npm run build

# Run the server
node build/index.js

Uso

Agrega la siguiente configuración al archivo de configuración de tu cliente MCP:

{
  "mcpServers": {
    "default-server": {
      "type": "streamable-http",
      "url": "http://localhost:3000/mcp",
      "note": "For Streamable HTTP connections, add this URL directly in your MCP Client"
    }
  }
}

Instala el inspector @modelcontextprotocol/inspector

npm install -g @modelcontextprotocol/inspector

Lista las herramientas con el inspector

mcp-inspector --cli --transport http --method tools/list --server-url --target http://localhost:3000/mcp

Llama a la herramienta markdown-to-mindmap

mcp-inspector --cli --transport http --method tools/call --server-url --target http://localhost:3000/mcp --tool-name markdown_to_mindmap --tool-arg markdown="
# header 1
## Header 1.1
- [x] ul 1
- [ ] ul 2
- [ ] ul 3
## Header 1.2
- bullet 1
- bullet 2
## Header 1.3
### Header 1.3.1
### Header 1.3.2
1. ol 1
2. ol 2
3. ol 3
"

Herramientas disponibles

markdown-to-mindmap

Convierte texto Markdown en un mapa mental interactivo.

Parámetros:

• markdown: El contenido Markdown a convertir (cadena obligatoria)

Valor de retorno:

{
  "tools": [
    {
      "name": "markdown_to_mindmap",
      "title": "Markdown to Mind Map Converter",
      "description": "Converts Markdown content to an interactive HTML mind map",
      "inputSchema": {
        "type": "object",
        "properties": {
          "markdown": {
            "type": "string",
            "description": "Markdown content to convert into a mind map"
          }
        },
        "required": ["markdown"]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "html": {
            "type": "string",
            "description": "HTML content of the generated mind map"
          },
          "contentLength": {
            "type": "number",
            "description": "Length of the HTML content"
          },
          "success": {
            "type": "boolean",
            "description": "Whether the conversion was successful"
          },
          "error": {
            "type": "string",
            "description": "Error message if conversion failed"
          }
        },
        "required": ["html", "contentLength", "success"],
        "additionalProperties": false
      }
    }
  ]
}

Licencia

Este proyecto está licenciado bajo la Licencia MIT.