MCP-Server de Mapas Mentais

目录

• 简介
• 项目结构
• 使用的技术
• 要求
• 如何在Claude Desktop上安装
• 有用的链接
• 贡献
• 许可证
• 联系

简介

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

项目结构

这个项目的灵感来自于UFG（戈亚斯联邦大学）的Sandeco Macedo教授通过书籍MCP e A2A para Leigos对MCPs的解释。这是一个简单的MCP-Server，仅使用FastMCP包，并遵循Anthropic官方仓库Model Context Protocol的指导。

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

• apresenta - 为一个主题生成演示用的思维导图；
• compara - 比较两个主题并生成思维导图；
• inicial - 为一个主题生成初始知识的思维导图；
• intermediario - 为一个主题生成中级知识的思维导图；
• problemas - 为与主题相关的分析问题生成思维导图；
• revisa - 为复习一个主题的内容生成思维导图。

使用的技术

要求

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

如何在 Claude Desktop 上安装

现在我将详细说明我在 Windows 11 上使用 VSCode 终端 (CTRL + SHIFT + ') 的步骤：

1. 我安装了 最新版本的 Python
2. 在 VSCode 中，我使用终端来检查 Python 版本，命令为

   python --version
   

3. 然后我用以下命令安装了 uv

   pip install uv
   

4. 为了确认一切正常，我使用了命令

   uv
   

5. 为了创建项目文件夹，我使用了这个命令

   mkdir "C:\Users\meu_usuario\OneDrive\area_de_trabalho\mapas_mentais"
   

[!IMPORTANT]
这并不意味着你必须使用相同的路径，你可以选择其他路径，例如下面的路径：

  mkdir "C:\Users\seu_usuario\mapas_mentais"

或者你可以直接从 GitHub 页面通过 Code > Download ZIP 下载此项目的压缩包到你的电脑上。

1. 我调用了刚刚创建的文件夹

   cd "C:\Users\meu_usuario\OneDrive\area_de_trabalho\mapas_mentais"
   

2. 我使用以下命令打开另一个 VSCode 窗口，并继续在该文件夹中执行其他命令

   code .
   

[!IMPORTANT]
如果您不想通过终端创建文件夹，您可以选择在桌面上或其他容易记住的位置创建一个新文件夹，以便在 VSCode 中使用快捷键 CTRL + O 打开。之后只需找到刚刚创建的文件夹，点击并打开它即可在 VSCode 中使用。或者直接将此仓库的整个文件夹导入到您的 VSCode 中。

1. 回到终端，我使用了下面的命令来初始化一个新的 Python 项目，自动生成配置文件和依赖项

   uv init
   

2. 然后我使用以下命令创建了一个隔离的 Python 虚拟环境以安装项目的依赖项

   uv venv
   

3. 要激活 .venv，我使用了以下命令

   .venv\Scripts\Activate.ps1
   

4. 我添加了项目所需的 MCP 依赖项

   uv add mcp[cli]
   

5. 使用下面的命令检查一切是否正常

   uv run mcp
   

[!IMPORTANT]
如果您的终端中出现以下信息，则表示一切正常

1. 为了创建 server.py 文件，我使用了这个命令

   uv init --script server.py
   

[!TIP]
由于您可能已经下载了该仓库的文件夹，因此此时 server.py 文件应该已经在您的 VSCode 中了。

1. 我直接在 claude_desktop_config.json 文件中安装了 MCP-Server 的如下 json

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

[!IMPORTANT]
如果您已正确安装 Claude Desktop，请按照以下路径访问计算机上的 claude_desktop_config.json 文件
14a. 打开 Claude Desktop 后，使用快捷键 CTRL + ,
14b. 点击“开发者”选项卡，然后点击“编辑配置”
14c. 寻找 claude_desktop_config.json 文件并在 VSCode 中正确编辑
14d. 使用 CTRL + S 保存文件
14e. 关闭 Claude Desktop 并稍后再重新打开
14f. 检查锤子图标确认 MCP 工具 "mapas_mentais" 是否已正确安装

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

有用的链接

请注意，在翻译过程中保持了原有的 Markdown 格式，并保留了所有代码块和链接内容不变。

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

贡献

欢迎贡献！如果您有任何改进此项目的想法，请随时 fork 仓库。

许可证

该项目根据 MIT 许可证许可 - 查看 LICENSE 文件以获取详情。

联系方式

Mário Lúcio - Prazo Certo®