markmap-http-mcp

Servidor MCP Markmap

O Servidor MCP Markmap é baseado no Model Context Protocol (MCP) que permite a conversão em um clique de texto Markdown em mapas mentais interativos, construído sobre o projeto de código aberto markmap. Os mapas mentais gerados suportam operações interativas ricas e podem ser exportados em vários formatos de imagem.

🎉 Explore Mais Ferramentas de Mapas Mentais

Experimente o MarkXMind - Um editor online que cria mapas mentais complexos usando a sintaxe simples XMindMark. Ele suporta pré-visualização em tempo real, exportação em múltiplos formatos (.xmind/.svg/.png) e importação de arquivos XMind existentes. Experimente agora!

Recursos

• 🌠 Markdown para Mapa Mental: Converta texto Markdown em mapas mentais interativos
• 🖼️ Exportação em Múltiplos Formatos: Suporte para exportação como imagens PNG, JPG e SVG
• 🔄 Operações Interativas: Suporte para zoom, expansão/recolhimento de nós e outros recursos interativos
• 📋 Cópia de Markdown: Cópia em um clique do conteúdo Markdown original
• 🌐 Pré-visualização Automática no Navegador: Opção para abrir automaticamente os mapas mentais gerados no navegador

Pré-requisitos

1. Node.js (v25)

Instalação

Instalação 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, você pode clonar o repositório e executar 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

Adicione a seguinte configuração ao seu arquivo de configuração do 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"
    }
  }
}

Instale o inspetor @modelcontextprotocol/inspector

npm install -g @modelcontextprotocol/inspector

Liste as ferramentas com o inspetor

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

Chame a ferramenta 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
"

Ferramentas Disponíveis

markdown-to-mindmap

Converta texto Markdown em um mapa mental interativo.

Parâmetros:

• markdown: O conteúdo Markdown a ser convertido (string obrigatória)

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
      }
    }
  ]
}

Licença

Este projeto está licenciado sob a Licença MIT.