Servidor de mapas mentales MCP

Un servicio de administración de servidor MCP dinámico que crea, ejecuta y administra servidores de Protocolo de contexto de modelo (MCP) de forma dinámica. Este servicio actúa como un servidor MCP e inicia/administra otros servidores MCP como procesos secundarios, lo que permite un ecosistema MCP flexible.

Introducción

El proyecto mapas_mentais es una aplicación Python que genera mapas mentales automatizados para facilitar el estudio, revisión, comparación y presentación de diferentes temas. Utilizando la idea del servidor MCP, el sistema proporciona información al interactuar directamente con Claude Desktop a través de los modelos de Claude. Ideal para estudiantes, profesores y profesionales que quieran organizar ideas de forma visual y eficiente, el proyecto es fácilmente extensible y puede integrarse con otros sistemas de automatización o asistentes virtuales.

Estructura del proyecto

La idea de este proyecto surgió de las explicaciones dadas por el profesor Sandeco Macedo, de la UFG (Universidad Federal de Goiás), sobre los MCP a través del libro MCP y A2A para Dummies . Es un MCP-Server simple que utiliza únicamente el paquete FastMCP, siguiendo también las pautas del repositorio oficial del Model Context Protocol , de Anthropic.

Los seis tipos de mapas mentales utilizados en este servidor MCP son:

presenta: genera un mapa mental para presentaciones sobre un tema;
comparar - Genera un mapa mental comparando dos temas;
inicial - Genera un mapa mental del conocimiento inicial sobre el tema;
intermedio - Genera un mapa mental del conocimiento intermedio sobre el tema;
Problemas - Genera un mapa mental de análisis de problemas relacionados con el tema;
revisión: genera un mapa mental para revisar el contenido sobre un tema.

Tecnologías utilizadas

Requisitos

Python instalado (versión 3.10 o superior);
Paquete uv instalado;
Claude Desktop instalado.

Cómo instalar en Claude Desktop

Ahora detallaré cómo fue mi paso a paso en Windows 11, usando la terminal (atajo CTRL + SHIFT + ' ) en VSCode:

He instalado la versión más actualizada de Python
En VSCode, usé la terminal para verificar la versión de Python con el comando
python --version
Así que instalé el uv con el control remoto.
pip install uv
Para comprobar si todo estaba bien, utilicé el comando
uv
Para crear la carpeta del proyecto, utilicé este comando
mkdir “C:\Users\meu_usuario\OneDrive\area_de_trabalho\mapas_mentais”

[!IMPORTANTE] Esto no significa necesariamente que utilizarás la misma ruta, es posible que desees utilizar otra ruta, como la que se muestra a continuación.
mkdir "C:\Users\seu_usuario\mapas_mentais"
O simplemente puedes descargar el zip de este proyecto a tu máquina a través de Code > Download ZIP aquí mismo en GitHub

Le puse nombre a la carpeta que acababa de crear
cd “C:\Users\meu_usuario\OneDrive\area_de_trabalho\mapas_mentais”
Utilicé el siguiente comando para abrir otra ventana de VSCode y continuar con los otros comandos directamente en la carpeta
code .

[!IMPORTANTE] Si no desea crear la carpeta a través de la terminal, puede crear una nueva carpeta en su escritorio u otra ubicación que recuerde fácilmente, para poder usar el atajo en VSCode CTRL + O Luego, simplemente busque la carpeta que acaba de crear, haga clic en ella y ábrala en VSCode. O simplemente importe la carpeta completa de este repositorio a su VSCode.

De vuelta en la terminal, utilicé el siguiente comando para inicializar un nuevo proyecto de Python, creando archivos de configuración y dependencias automáticamente.
uv init
Luego usé el siguiente comando para crear un entorno virtual de Python aislado para instalar las dependencias del proyecto.
uv venv
Para activar .venv, utilicé el siguiente comando

.venv\Scripts\Activate.ps1

Agregué la dependencia MCP, que es necesaria para el proyecto.

uv add mcp[cli]

Verifiqué si todo estaba bien, con el siguiente comando

uv run mcp

[!IMPORTANTE] Si la siguiente información aparece en tu terminal, todo está bien.

Para crear el archivo server.py , utilicé este comando

uv init --script server.py

[!TIP] Dado que es posible que ya hayas descargado la carpeta para este repositorio, el archivo server.py ya estará en tu VSCode en este momento.

Instalé el json a continuación desde MCP-Server directamente en el archivo claude_desktop_config.json

"mapas_mentais": {
  "command": "uv",
  "args": [
    "run",
    "--with",
    "mcp[cli]",
    "mcp",
    "run",
    "C:\\Users\\meu_usuario\\OneDrive\\area_de_trabalho\\mapas_mentais\\server.py"
  ]
}

[!IMPORTANTE] Si ya ha instalado Claude Desktop correctamente, siga la ruta para acceder al archivo claude_desktop_config.json en su computadora
14º. Con Claude Desktop abierto, utilice el atajo CTRL + ,
14b. Haga clic en la pestaña Desenvolvedor y luego haga clic en Editar configuração
14c. Busque el archivo claude_desktop_config.json y edítelo en VSCode correctamente
14d. Guarde el archivo con CTRL + S
14ª edición. Cierre Claude Desktop y vuelva a abrirlo después de unos segundos.
14 y siguientes. Verifique el ícono del martillo para ver si las herramientas "mental_maps" de MCP están instaladas correctamente
Las herramientas se denominaron “presente”, “comparar”, “inicial”, “intermedio”, “problemas” y “revisión”.

Enlaces útiles

Documentación oficial del Protocolo de Contexto Modelo - Conocerás todos los detalles de esta innovación de Anthropic
Sitio web oficial de Anthropic : para mantenerse al día con las últimas noticias y estudios sobre los modelos Claude
Cómo descargar Claude Desktop - Enlace de descarga directa
Cómo instalar VSCode - Enlace de descarga directa
Documentación oficial del paquete uv : conocerás todos los detalles sobre uv y su importancia en Python.
venv — Creación de entornos virtuales - Explicación completa de cómo funcionan los venv
Conjunto de iconos de modelos AI/LMM : un excelente sitio para obtener iconos del ecosistema de IA
Devicon - sitio muy completo también con iconos generales sobre tecnología

Contribuciones

¡Las contribuciones son bienvenidas! Si tienes ideas para mejorar este proyecto, no dudes en bifurcar el repositorio.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Contacto

Mario Lucio - Deadline®

MCP-Server de Mapas Mentais