MCP-Server de Mapas Mentais
7 stars
177 downloads
Not rated
About
Repositório com um MCP-Server simples com seis tipos de mapas mentais diferentes.
Details
- Author
- marioluciofjr
- GitHub stars
- 7
- Downloads
- 177
- Categories
- Other
Jump to
- Offers six distinct mind‑map types for different purposes.
- Integrates directly with Claude Desktop via the MCP protocol.
- Built with Python 3.10+ and the FastMCP package.
- Easy to extend and adapt to other automation systems.
- Licensed under MIT – open source and community‑friendly.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP-Server de Mapas MentaisCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via Smithery (npx -y @smithery/cli install @marioluciofjr/mapas_mentais_mcp --client claude) or set up manually by adding a "mapas_mentais" entry to the claude_desktop_config.json file with uv pointing to the project directory. Once configured, invoke tools such as apresenta, compara, inicial, intermediario, problemas, and revisa through Claude Desktop.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp-server de mapas mentais": {
"mapas_mentais_mcp": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@marioluciofjr/mapas_mentais_mcp",
"--client",
"claude"
]
}
}
}
}McpServers
{
"mapas_mentais_mcp": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@marioluciofjr/mapas_mentais_mcp",
"--client",
"claude"
]
}
}MCP-Server de Mapas Mentais
Índice
Introdução Estrutura do projeto Tecnologias utilizadas Requisitos Como instalar no Claude Desktop Links úteis Contribuições Licença ContatoIntroduçã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
<div>
 
Requisitos
Python instalado (versão 3.10 ou superior); Pacoteuv instalado;
Claude Desktop instalado.
Como instalar no Claude Desktop
Installing via Smithery
To install Mapas Mentais Server for Claude Desktop automatically via Smithery: ``bash
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
`powershell
python --version
`
3. Depois eu instalei o uv com o comando
`powershell
pip install uv
`
4. Para conferir se estava tudo certo, eu utilizei o comando
`powershell
uv
`
5. Para criar a pasta do projeto, eu utilizei este comando
`powershell
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
> `powershell
> 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
>
> 
6. Chamei a pasta que eu tinha acabado de criar
`powershell
cd “C:\Users\meu_usuario\OneDrive\area_de_trabalho\mapas_mentais”
`
7. 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 VSCode
> CTRL + 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.
8. Voltando ao terminal, utilizei o comando abaixo para inicializar um novo projeto Python, criando arquivos de configuração e dependências automaticamente
`powershell
uv init
`
9. Utilizei em seguida o comando abaixo para criar um ambiente virtual Python isolado para instalar dependências do projeto
`powershell
uv venv
`
10. Para ativar o .venv, utilizei o comando abaixo
`powershell
.venv\Scripts\Activate.ps1
`
11. Adicionei a dependência MCP, necessária para o projeto
`powershell
uv add mcp[cli]
`
12. Verifiquei se estava tudo ok, com o comando abaixo
`powershell
uv run mcp
`
> [!IMPORTANT]
> Se aparecer esta informação abaixo no seu terminal é porque está tudo certo
>
> 
13. Para criar o arquivo server.py, eu utilizei esse comando
`powershell
uv init --script server.py
`
> [!TIP]
> Como você pode já ter baixado a pasta desse repositório, então o arquivo server.pyjá estará lá no seu VSCode nessa altura do campeonato.
14. Instalei o json abaixo do MCP-Server diretamente no arquivo claude_desktop_config.json
`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 arquivo claude_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
>
> 
>
> As ferramentas foram nomeadas como "apresenta", "compara", "inicial", "intermediario", "problemas" e "revisa".
Links úteis
Documentação oficial do Model Context Protocol - Você saberá todos os detalhes dessa inovação da Anthropic Site oficial da Anthropic - Para ficar por dentro das novidaddes e estudos dos modelos Claude Como baixar o Claude Desktop - Link direto para download Como instalar o VSCode- Link direto para download Documentação oficial do pacote uv - Você saberá todos os detalhes sobre ouv e como ele é importante no python
venv — Criação de ambientes virtuais - Explicação completa de como funcionam os venvs
Conjunto de ícones de modelos de IA/LLM - site muito bom para conseguir ícones do ecossistema de IA
Devicon - site bem completo também com ícones gerais sobre tecnologia
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® <div> <a href="https://www.linkedin.com/in/marioluciofjr" target="_blank">
</a>
<a href = "mailto:marioluciofjr@gmail.com" target="_blank">
</a>
<a href="https://prazocerto.me/contato" target="_blank">
</a>
</div>Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
