Skip to main content
Glama
deenesjakoptruzh
marioluciofjr

MCP-Server de Mapas Mentais

by marioluciofjr
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

MCP-Mind Map Server

Made with Python license - MITwebsite - prazocerto.melinkedin - @marioluciofjr

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

Index

Related MCP server: CaptureMind

Introduction

The mapas_mentais project is a Python application that generates automated mind maps to facilitate the study, review, comparison and presentation of different topics. Using the idea of MCP-server, the system provides insights by interacting directly with Claude Desktop through Claude models. Ideal for students, teachers and professionals who want to organize ideas visually and efficiently, the project is easily extensible and can be integrated with other automation systems or virtual assistants.

Project structure

The idea for this project came from the explanations given by Professor Sandeco Macedo, from UFG (Federal University of Goiás), about MCPs through the book MCP and A2A for Dummies . It is a simple MCP-Server that uses only the FastMCP package, also following the guidelines of the official repository of the Model Context Protocol , from Anthropic.

The six types of mind maps used in this MCP-Server are:

  • presents - Generates a mind map for presentations on a topic;

  • compare - Generates a mind map comparing two topics;

  • initial - Generates a mental map of initial knowledge about the topic;

  • intermediate - Generates a mind map of intermediate knowledge on the topic;

  • problems - Generates a mental map of analysis of problems related to the topic;

  • review - Generates a mind map to review content on a topic.

Technologies used

Requirements

  • Python installed (version 3.10 or higher);

  • uv package installed;

  • Claude Desktop installed.

How to install on Claude Desktop

Now I will detail how my step by step was in Windows 11, using the terminal (shortcut CTRL + SHIFT + ' ) in VSCode:

  1. I have installed the most up-to-date version of Python

  2. In VSCode, I used the terminal to check the python version with the command

    python --version

  3. So I installed the uv with the remote control

    pip install uv

  4. To check if everything was ok, I used the command

    uv

  5. To create the project folder, I used this command

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

[!IMPORTANT] This does not necessarily mean that you will use the same path, you may want to use another path, like the one below.

  mkdir "C:\Users\seu_usuario\mapas_mentais"

Or you can simply download the zip of this project to your machine via Code > Download ZIP right here on GitHub

Image

  1. I named the folder I had just created

    cd “C:\Users\meu_usuario\OneDrive\area_de_trabalho\mapas_mentais”

  2. I used the command below to open another VSCode window and continue with the other commands directly in the folder

    code .

[!IMPORTANT] If you don't want to create the folder via terminal, you can create a new folder on your desktop or another location that you easily remember, in order to use the shortcut in VSCode CTRL + O Then just look for the folder you just created, click on it and open it in VSCode. Or just import the complete folder of this repository into your VSCode.

  1. Back in the terminal, I used the command below to initialize a new Python project, creating configuration files and dependencies automatically

    uv init

  2. I then used the command below to create an isolated Python virtual environment to install project dependencies.

    uv venv

  3. To activate .venv, I used the command below

.venv\Scripts\Activate.ps1

  1. I added the MCP dependency, which is necessary for the project

uv add mcp[cli]

  1. I checked if everything was ok, with the command below

uv run mcp

[!IMPORTANT] If the information below appears on your terminal, everything is fine.

Image

  1. To create the server.py file, I used this command

uv init --script server.py

[!TIP] Since you may have already downloaded the folder for this repository, the server.py file will already be there in your VSCode at this point.

  1. I installed the json below from MCP-Server directly into the claude_desktop_config.json file

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

[!IMPORTANT] If you have already installed Claude Desktop correctly, follow the path to access the claude_desktop_config.json file on your computer
14th. With Claude Desktop open, use the shortcut CTRL + ,
14b. Click on the Desenvolvedor tab and then click on Editar configuração
14c. Find the claude_desktop_config.json file and edit it in VSCode correctly
14d. Save the file with CTRL + S
14e. Close Claude Desktop and reopen it after a few seconds
14f. Check the configuration icon to see if the MCP "mental_maps" tools are installed correctly

Image

The tools were named `"present", "compare", "initial", "intermediate", "problems" and "review".

Useful links

Contributions

Contributions are welcome! If you have ideas to improve this project, feel free to fork the repository.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contact

Mario Lucio - Deadline®

Available Tools

6 tools
apresentaC

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

ParametersJSON Schema
NameRequiredDescriptionDefault
temaYes

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the tool generates a mind map but doesn't describe what format the output takes (e.g., text, image, structured data), whether it's a read-only or mutating operation, or any performance characteristics. For a generation tool with zero annotation coverage, this leaves significant behavioral gaps.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise - a single sentence that directly states the tool's function. There's no wasted language or unnecessary elaboration. It's appropriately sized for a simple tool with one parameter.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no annotations, no output schema, and minimal parameter documentation, the description is incomplete. It tells what the tool does at a high level but doesn't provide enough information about how to use it effectively, what to expect as output, or how it differs from sibling tools. For a generation tool, more context about output format and behavioral characteristics would be helpful.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 1 parameter with 0% description coverage, and the tool description doesn't mention any parameters at all. While the parameter 'tema' (topic) is self-explanatory, the description provides no additional context about what constitutes a valid topic, format expectations, or examples. With low schema coverage, the description fails to compensate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Gera um mapa mental para apresentações sobre um tema' (Generates a mind map for presentations on a topic). It specifies the verb ('gera' - generates) and resource ('mapa mental' - mind map) with the context of presentations. However, it doesn't differentiate from sibling tools like 'compara' or 'revisa' which might have related functions.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention any prerequisites, exclusions, or suggest when to choose this over sibling tools like 'compara' or 'revisa'. The usage context is implied (for presentations on a topic) but lacks explicit when/when-not instructions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

comparaC

Gera um mapa mental comparando dois temas.

ParametersJSON Schema
NameRequiredDescriptionDefault
tema1Yes
tema2Yes

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. While 'gera' (generates) implies a creation operation, the description doesn't specify whether this is a read-only or mutating action, what permissions might be required, whether there are rate limits, or what the output format looks like. For a tool with zero annotation coverage, this leaves significant behavioral gaps.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence: 'Gera um mapa mental comparando dois temas.' It's front-loaded with the core action and includes all essential elements (action, resource, scope) without any wasted words. Every part of the sentence contributes directly to understanding the tool's function.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity (a mind map generation tool with two parameters), lack of annotations, and no output schema, the description is insufficiently complete. It doesn't explain what the mind map output contains, how comparisons are structured, whether there are limitations on theme complexity, or what happens if themes are invalid. For a creative/generation tool, more contextual guidance would be helpful.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description mentions 'dois temas' (two themes), which aligns with the two parameters (tema1 and tema2) in the schema. However, with 0% schema description coverage, the schema provides no details about these parameters. The description adds basic semantic context (they represent themes to compare) but doesn't elaborate on format, constraints, or examples. This meets the baseline for minimal parameter information.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Gera um mapa mental comparando dois temas' (Generates a mind map comparing two themes). It specifies the verb ('gera' - generates), resource ('mapa mental' - mind map), and scope ('comparando dois temas' - comparing two themes). However, it doesn't explicitly distinguish this from sibling tools like 'apresenta' or 'revisa', which might also involve presentation or review functions.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. There are no explicit instructions about when this tool is appropriate, when it should not be used, or what sibling tools might serve as alternatives for related tasks. The agent must infer usage from the purpose alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

inicialC

Gera um mapa mental de conhecimentos iniciais sobre o tema.

ParametersJSON Schema
NameRequiredDescriptionDefault
temaYes

TDQS

C2.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It mentions generation but doesn't disclose behavioral traits like whether this is a read-only operation, if it requires authentication, rate limits, or what format the mind map output takes. The description is minimal and lacks essential operational context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that directly states the tool's function. It's appropriately sized and front-loaded with the core action, though it could be more structured with additional context.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (generating a mind map), lack of annotations, no output schema, and minimal parameter details, the description is incomplete. It doesn't explain what the output looks like, how the mind map is structured, or any limitations, leaving significant gaps for the agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate. It implies the parameter 'tema' is the topic for the mind map, adding some meaning beyond the bare schema. However, with only one parameter, the baseline is 4, but the description doesn't fully detail the parameter's semantics (e.g., format, scope), so it scores slightly lower.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states the tool 'generates an initial knowledge mind map about the topic', which provides a clear verb ('generates') and resource ('mind map'). However, it doesn't specify what distinguishes this from sibling tools like 'apresenta' or 'revisa', leaving the purpose somewhat vague in context.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites, appropriate contexts, or exclusions, leaving the agent with no usage direction beyond the basic purpose.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

intermediarioC

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

ParametersJSON Schema
NameRequiredDescriptionDefault
temaYes

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the tool generates a mind map, implying a read-only or creative operation, but doesn't clarify if it requires specific inputs beyond the topic, how the output is structured, whether it's cached or real-time, or any error conditions. For a tool with zero annotation coverage, this leaves significant gaps in understanding its behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence in Portuguese: 'Gera um mapa mental de conhecimentos intermediários sobre o tema.' It is front-loaded with the core action and resource, with no wasted words. Every part of the sentence contributes to understanding the tool's purpose efficiently.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has no annotations, no output schema, and low schema description coverage (0%), the description is incomplete. It doesn't explain what 'conhecimentos intermediários' (intermediate knowledge) means, how the mind map is returned (e.g., text, image, structured data), or any limitations. For a tool that likely produces complex output, more context is needed to use it effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description mentions 'sobre o tema' (on the topic), which aligns with the single parameter 'tema' (topic) in the input schema. However, schema description coverage is 0%, so the schema provides no additional details about the parameter. The description adds minimal semantic context by implying the parameter is a topic string, but doesn't specify format, length, or examples. With one parameter and low coverage, this is adequate but basic.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Gera um mapa mental de conhecimentos intermediários sobre o tema' (Generates a mind map of intermediate knowledge on the topic). It specifies the action (generate), the resource (mind map), and the scope (intermediate knowledge on a topic). However, it doesn't explicitly distinguish this tool from its siblings like 'inicial' or 'revisa', which might also be related to knowledge mapping or topic exploration.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention any prerequisites, context for 'intermediate knowledge', or how it differs from sibling tools such as 'apresenta', 'compara', 'inicial', 'problemas', or 'revisa'. Without this information, an AI agent must guess based on tool names alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

problemasC

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

ParametersJSON Schema
NameRequiredDescriptionDefault
temaYes

TDQS

C2.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the tool generates a mind map but doesn't describe what the output looks like (e.g., format, structure), whether it's a read-only or mutative operation, or any constraints like rate limits or permissions. For a tool with zero annotation coverage, this is a significant gap in behavioral context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that directly states the tool's function without unnecessary words. It's appropriately sized for a simple tool, though it could be more front-loaded with additional context if needed. The structure is clear but minimal.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (simple with 1 parameter), lack of annotations, and no output schema, the description is incomplete. It doesn't explain the return values (e.g., what the mind map output entails), behavioral traits, or detailed parameter usage. For a tool with no structured data support, the description should provide more comprehensive context to guide the agent effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 1 parameter ('tema') with 0% description coverage in the schema itself. The tool description mentions 'related to the theme', which loosely maps to the 'tema' parameter, but doesn't add meaningful semantics such as what constitutes a valid theme, examples, or constraints. With low schema coverage, the description fails to adequately compensate for the lack of parameter documentation.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states the tool 'generates a mind map for problem analysis related to the theme', which provides a clear verb ('generates') and resource ('mind map'). However, it doesn't distinguish this from sibling tools like 'apresenta' or 'compara', leaving the specific differentiation unclear. The purpose is understandable but lacks sibling context.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives like 'apresenta' or 'compara'. It implies usage for problem analysis related to a theme, but doesn't specify prerequisites, exclusions, or comparative contexts with other tools. This leaves the agent with minimal direction for tool selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

revisaC

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

ParametersJSON Schema
NameRequiredDescriptionDefault
temaYes

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. While 'gera' (generates) implies a creation operation, the description doesn't specify whether this is a read-only or mutative action, what permissions might be required, whether the output is stored or temporary, or any rate limits. It mentions the output type (mind map) but not its format or structure.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence in Portuguese that directly states the tool's function. It is appropriately sized and front-loaded with the core action, with no unnecessary words or redundant information. Every word earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity (a tool that generates a mind map), lack of annotations, no output schema, and low schema coverage, the description is incomplete. It doesn't explain what the mind map output looks like, how it's structured, whether it's visual or textual, or any behavioral aspects like error handling. For a generative tool with no structured data, this leaves significant gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description adds minimal meaning beyond the input schema. It mentions 'tema' (topic) as the subject for the mind map, which aligns with the single parameter 'tema' in the schema. However, with 0% schema description coverage, the parameter is undocumented in the schema, and the description doesn't elaborate on what constitutes a valid 'tema' or provide examples. The baseline is 3 since schema coverage is low but the description partially compensates.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Gera um mapa mental para revisão de conteúdo sobre um tema' (Generates a mind map for content review on a topic). It specifies the verb ('gera' - generates), resource ('mapa mental' - mind map), and context ('revisão de conteúdo' - content review). However, it doesn't differentiate from sibling tools like 'apresenta' or 'compara', which likely have different functions.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention when this tool is appropriate, when to use sibling tools instead, or any prerequisites. The context is implied (content review on a topic) but lacks explicit usage boundaries.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

TDQS

B3.1/5.0
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
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • Markmap MCP Server

    jiushan-test
    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.
    34
    1
    MIT

  • mindkeeper-mcp

    icedsg
    A
    license
    A
    quality
    D
    maintenance
    Captures ideas from conversations and organizes them into a persistent, hierarchical mindmap. Supports search, deduplication, export, import, and cloud sync.
    13
    25
    MIT

Appeared in Searches

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/marioluciofjr/mapas_mentais_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server