Skip to main content
Glama
MCP-Server de Mapas Mentais

MCP-Server de Mapas Mentais

MCP-Server de Mapas Mentais

Made with Python license - MIT site - prazocerto.me linkedin - @marioluciofjr

A dynamic MCP server management service that creates, runs, and manages Model Context Protocol (MCP) servers dynamically. This service itself functions as an MCP server and launches/manages other MCP servers as child processes, enabling a flexible MCP ecosystem.

Índice

Related MCP server: CaptureMind

Introdução

O projeto mapas_mentais é uma aplicação Python que gera mapas mentais automatizados para facilitar o estudo, revisão, comparação e apresentação de temas diversos. Utilizando a ideia de MCP-server, o sistema oferece insights ao interagir diretamente com o Claude Desktop por meio dos modelos Claude. Ideal para estudantes, professores e profissionais que desejam organizar ideias de forma visual e eficiente, o projeto é facilmente extensível e pode ser integrado a outros sistemas de automação ou assistentes virtuais.

Estrutura do projeto

A ideia desse projeto surgiu a partir das explicações do professor Sandeco Macedo, da UFG (Universidade Federal de Goiás), sobre MCPs por meio do livro MCP e A2A para Leigos . É um MCP-Server simples que utiliza somente o pacote FastMCP, seguindo também as orientações do repositório oficial do Model Context Protol, da Anthropic.

Os seis tipos de mapas mentais utilizados neste MCP-Server são:

  • apresenta - Gera um mapa mental para apresentações sobre um tema;

  • compara - Gera um mapa mental comparando dois temas;

  • inicial - Gera um mapa mental de conhecimentos iniciais sobre o tema;

  • intermediario - Gera um mapa mental de conhecimentos intermediários sobre o tema;

  • problemas - Gera um mapa mental de análise de problemas relacionados ao tema;

  • revisa - Gera um mapa mental para revisão de conteúdo sobre um tema.

Tecnologias utilizadas

Requisitos

  • Python instalado (versão 3.10 ou superior);

  • Pacote uv instalado;

  • Claude Desktop instalado.

Como instalar no Claude Desktop

Installing via Smithery

To install Mapas Mentais Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @marioluciofjr/mapas_mentais_mcp --client claude

Agora vou detalhar como foi o meu passo a passo no Windows 11, utilizando o terminal (atalho CTRL + SHIFT + ') no VSCode:

  1. Instalei a versão mais atualizada do Python

  2. Já no VSCode, eu utizei o terminal para verificiar a versão do python com o comando

    python --version
  3. Depois eu instalei o uv com o comando

    pip install uv
  4. Para conferir se estava tudo certo, eu utilizei o comando

    uv
  5. Para criar a pasta do projeto, eu utilizei este comando

    mkdir “C:\Users\meu_usuario\OneDrive\area_de_trabalho\mapas_mentais”
IMPORTANT

Não necessariamente quer dizer que você utilizará o mesmo caminho, pode ser que você queira utilizar outro caminho, como este abaixo

  mkdir "C:\Users\seu_usuario\mapas_mentais"

Ou você pode simplesmente fazer o download do zip desse projeto para a sua máquina pelo caminho Code > Download ZIP aqui mesmo no GitHub

Image

  1. Chamei a pasta que eu tinha acabado de criar

    cd “C:\Users\meu_usuario\OneDrive\area_de_trabalho\mapas_mentais”
  2. Utilizei o comando abaixo para abrir outra janela do VSCode e continuar com os demais comandos direto na pasta

    code .
IMPORTANT

Se não quiser criar a pasta via terminal, você pode criar uma nova pasta na sua área de trabalho ou outro local que se lembre facilmente, a fim de utilizar o atalho no VSCodeCTRL + O Depois é só procurar a pasta que acabou de criar, clicar nela e abrir no VSCode. Ou somente importar a pasta completa desse repositório no seu VSCode.

  1. Voltando ao terminal, utilizei o comando abaixo para inicializar um novo projeto Python, criando arquivos de configuração e dependências automaticamente

    uv init
  2. Utilizei em seguida o comando abaixo para criar um ambiente virtual Python isolado para instalar dependências do projeto

    uv venv
  3. Para ativar o .venv, utilizei o comando abaixo

    .venv\Scripts\Activate.ps1
  4. Adicionei a dependência MCP, necessária para o projeto

    uv add mcp[cli]
  5. Verifiquei se estava tudo ok, com o comando abaixo

    uv run mcp
IMPORTANT

Se aparecer esta informação abaixo no seu terminal é porque está tudo certo

Image

  1. Para criar o arquivo server.py, eu utilizei esse comando

    uv init --script server.py
TIP

Como você pode já ter baixado a pasta desse repositório, então o arquivoserver.pyjá estará lá no seu VSCode nessa altura do campeonato.

  1. Instalei o json abaixo do MCP-Server diretamente no arquivo claude_desktop_config.json

    "mapas_mentais": {
      "command": "uv",
      "args": [
        "--directory",
        "C://Users//meu_usuario//OneDrive//area_de_trabalho//mapas_mentais",
        "run",
        "server.py"
      ]
    }
IMPORTANT

Se você já instalou o Claude Desktop corretamente, siga o caminho para acessar o arquivoclaude_desktop_config.json no seu computador
14a. Com o Claude Desktop aberto, utilize o atalho CTRL + ,
14b. Clique na aba Desenvolvedor e depois em Editar configuração
14c. Procure o arquivo claude_desktop_config.json e edite no VSCode corretamente
14d. Salve o arquivo com CTRL + S
14e. Feche o Claude Desktop e abra novamente depois de alguns segundos
14f. Confira no ícone de configuração se as ferramentas do MCP "mapas_mentais" estão instaladas corretamente

Image

As ferramentas foram nomeadas como `"apresenta", "compara", "inicial", "intermediario", "problemas" e "revisa".

Contribuições

Contribuições são bem-vindas! Se você tem ideias para melhorar este projeto, sinta-se à vontade para fazer um fork do repositório.

Licença

Este projeto está licenciado sob a licença MIT - veja o arquivo LICENSE para detalhes.

Contato

Mário Lúcio - Prazo Certo®

Available Tools

6 tools
apresentaC

Gera um mapa mental para apresentações sobre um tema.

Inputs: tema (required).

comparaC

Gera um mapa mental comparando dois temas.

Inputs: tema1 (required), tema2 (required).

inicialC

Gera um mapa mental de conhecimentos iniciais sobre o tema.

Inputs: tema (required).

intermediarioC

Gera um mapa mental de conhecimentos intermediários sobre o tema.

Inputs: tema (required).

problemasC

Gera um mapa mental de análise de problemas relacionados ao tema.

Inputs: tema (required).

revisaC

Gera um mapa mental para revisão de conteúdo sobre um tema.

Inputs: tema (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 6 tools

    Disambiguation3/5

    The tools have overlapping purposes as they all generate mind maps, but their descriptions help differentiate them by specifying distinct contexts like presentations, comparisons, knowledge levels, problem analysis, and review. However, 'inicial' and 'intermediario' could be confused as they both relate to knowledge levels without clear boundaries.

    Naming Consistency5/5

    All tool names follow a consistent pattern using Portuguese verbs in a simple, uniform style (e.g., 'apresenta', 'compara', 'inicial'). There are no deviations in naming conventions, making them predictable and readable.

    Tool Count5/5

    With 6 tools, the count is well-scoped for a mind map generation server, covering various use cases like presentations, comparisons, and reviews. Each tool appears to serve a distinct purpose, making the set appropriately sized.

    Completeness4/5

    The tool surface covers key mind map generation scenarios, including creation for different contexts and review. A minor gap exists in lacking explicit update or delete operations for existing mind maps, but agents can likely work around this by regenerating maps as needed.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables conversion of plain text descriptions and Markdown content into interactive mind maps using AI. Automatically uploads generated mind maps to Aliyun OSS and provides online access links.
      48 npm
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Captures ideas from conversations and organizes them into a persistent, hierarchical mindmap. Supports search, deduplication, export, import, and cloud sync.
      13
      7 npm
      MIT