思维导图mcp

Name: 思维导图mcp
Author: marioluciofjr

作者：marioluciofjr7 星标更新：2025-07-22

安装使用来源：spider==github.com

项目介绍

MCP-Server 思维导图

一个动态的 MCP 服务器管理服务，用于创建、运行和管理模型上下文协议（MCP）服务器。该服务本身作为一个 MCP 服务器运行，并作为子进程启动和管理其他 MCP 服务器，从而实现灵活的 MCP 生态系统。

简介

该项目 mapas_mentais 是一个 Python 应用程序，它自动生成思维导图以帮助学习、复习、比较和展示各种主题。通过使用 MCP-server 的概念，系统可以直接与 Claude Desktop 交互，提供见解。对于希望以视觉和高效方式组织想法的学生、教师和专业人士来说，这个项目非常适合。该项目易于扩展，可以集成到其他自动化系统或虚拟助手中。

项目结构

这个项目的构想源于 UFG（戈亚斯联邦大学）教授 Sandeco Macedo 关于 MCP 的解释，这些解释来自书籍《MCP 和 A2A 对初学者》。这是一个简单的 MCP-Server，仅使用 FastMCP 包，并遵循 Anthropic 官方仓库 Model Context Protocol 的指导。

此 MCP-Server 使用的六种类型的思维导图是：

展示 - 生成关于某个主题的演示思维导图；
比较 - 生成比较两个主题的思维导图；
初始 - 生成关于某个主题的初始知识思维导图；
中级 - 生成关于某个主题的中级知识思维导图；
问题 - 生成分析与某个主题相关的问题的思维导图；
复习 - 生成关于某个主题的内容复习思维导图。

使用的工具和技术

需求

已安装 Python（版本 3.10 或更高版本）；
已安装 uv 包；
已安装 Claude Desktop。

如何在 Claude Desktop 上安装

通过 Smithery 安装

要通过 Smithery 自动安装 Mapas Mentais Server for Claude Desktop：

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

现在我将详细介绍我在 Windows 11 上的步骤，使用终端（快捷键 CTRL + SHIFT + '）在 VSCode 中进行操作：

安装了最新版本的 Python。
在 VSCode 中，我使用终端来检查 Python 版本，使用以下命令：
```
python --version
```
然后我使用以下命令安装了 uv：
```
pip install uv
```
为了确认一切正常，我使用了以下命令：
```
uv
```

创建项目文件夹时，我使用了以下命令：

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

[!重要] 这并不意味着您必须使用相同的路径，您可以选择其他路径，例如：
mkdir "C:\Users\seu_usuario\mapas_mentais"
或者，您可以直接从 GitHub 下载此项目的 zip 文件到您的机器，路径为 Code > Download ZIP。

我调用了刚刚创建的文件夹：

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

我使用以下命令打开另一窗口的 VSCode 并继续在文件夹中执行其他命令：
```
code .
```

[!重要] 如果不想通过终端创建文件夹，您可以在桌面上或其他容易记住的位置创建一个新的文件夹，然后使用 VSCode 的快捷键 CTRL + O 打开它。或者，您可以直接将此存储库的整个文件夹导入到您的 VSCode 中。

回到终端，我使用以下命令初始化了一个新的 Python 项目，自动创建了配置文件和依赖项：
```
uv init
```
接下来，我使用以下命令创建了一个独立的 Python 虚拟环境，用于安装项目的依赖项：
```
uv venv
```
为了激活 .venv，我使用了以下命令：
```
.venv\Scripts\Activate.ps1
```
添加了项目所需的 MCP 依赖项：
```
uv add mcp[cli]
```
使用以下命令检查是否一切正常：
```
uv run mcp
```

[!重要] 如果您的终端显示以下信息，则表示一切正常：

为了创建 server.py 文件，我使用了以下命令：
```
uv init --script server.py
```

[!提示] 如果您已经下载了此存储库的文件夹，那么 server.py 文件已经在您的 VSCode 中了。

我直接在 claude_desktop_config.json 文件中安装了以下 MCP-Server 的 JSON：

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

[!重要] 如果您已经正确安装了 Claude Desktop，请按照以下步骤访问 claude_desktop_config.json 文件： 14a. 打开 Claude Desktop，使用快捷键 CTRL + ,。 14b. 点击“开发者”选项卡，然后点击“编辑配置”。 14c. 查找并正确编辑 claude_desktop_config.json 文件。 14d. 使用 CTRL + S 保存文件。 14e. 关闭 Claude Desktop 并几秒钟后再重新打开。 14f. 检查配置图标，确保 MCP 工具“mapas_mentais”已正确安装。

这些工具被命名为 "apresenta", "compara", "inicial", "intermediario", "problemas" 和 "revisa"。

有用的链接

Model Context Protocol 官方文档 - 您将了解 Anthropic 的这项创新的所有细节。
Anthropic 官方网站 - 了解 Claude 模型的新进展和研究。
如何下载 Claude Desktop - 直接下载链接。
如何安装 VSCode - 直接下载链接。
uv 包官方文档 - 您将了解 uv 的所有细节及其在 Python 中的重要性。
venv — 创建虚拟环境 - 完整解释 venv 的工作原理。
AI/LLM 模型图标集 - 获取 AI 生态系统图标的优秀网站。
Devicon - 提供全面技术图标集的网站。

贡献

欢迎贡献！如果您有改进此项目的建议，请随意 fork 此存储库。

许可证

本项目根据 MIT 许可证发布 - 详情见 LICENSE 文件。

联系

Mário Lúcio - Prazo Certo®