MCP-Server de Mapas Mentais

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

• Introdução

• Estrutura do projeto

• Tecnologias utilizadas

• Requisitos

• Como instalar no Claude Desktop

• Links úteis

• Contribuições

• Licença

• Contato

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

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”

6. Chamei a pasta que eu tinha acabado de criar

   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 .

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

   uv init

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

   uv venv

10. Para ativar o .venv, utilizei o comando abaixo

    .venv\Scripts\Activate.ps1

11. Adicionei a dependência MCP, necessária para o projeto

    uv add mcp[cli]

12. Verifiquei se estava tudo ok, com o comando abaixo

    uv run mcp

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

    uv init --script server.py

14. 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" ] }

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 o uv 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®