Mindmap MCP 服务器

<p align="center"> <img src="https://raw.githubusercontent.com/YuChenSSR/pics/master/imgs/2025-03-21/JMi7Mn89Hw5ikd9z.jpeg" alt="mindmap_mcp" width="50%"> </p>

一个模型上下文协议 (MCP) 服务器，用于将 Markdown 内容转换为交互式思维导图。

安装

pip install mindmap-mcp-server

或者使用 uvx:

uvx mindmap-mcp-server

或者使用 docker 更安全和容易。

前提条件

当使用命令 python 或 uvx 运行服务器时，此软件包需要安装 Node.js。

用法

与 Claude Desktop 或其他 MCP 客户端一起使用

将此服务器添加到您的 claude_desktop_config.json：

<details>

<summary>使用 uvx:</summary>

{
  "mcpServers": {
    "mindmap": {
      "command": "uvx",
      "args": ["mindmap-mcp-server", "--return-type", "html"]
    }
  }
}

或者

推荐：

{
  "mcpServers": {
    "mindmap": {
      "command": "uvx",
      "args": ["mindmap-mcp-server", "--return-type", "filePath"]
    }
  }
}

我们使用 --return-type 来指定思维导图内容的返回类型，您可以根据您的需求选择 html 或 filePath。 html 将返回思维导图的整个 HTML 内容，您可以在 AI 客户端的 artifact 中预览；

filePath 将把思维导图保存到一个文件并返回文件路径，您可以在浏览器中打开它。 它可以节省您的 tokens！

</details>

<details> <summary>使用 python:</summary>

使用此存储库中的特定 Python 文件：

{
  "mcpServers": {
    "mindmap": {
      "command": "python",
      "args": ["/path/to/your/mindmap_mcp_server/server.py", "--return-type", "html"]
    }
  }
}

或者

{
  "mcpServers": {
    "mindmap": {
      "command": "python",
      "args": ["/path/to/your/mindmap_mcp_server/server.py", "--return-type", "filePath"]
    }
  }
}

我们使用 --return-type 来指定思维导图内容的返回类型，您可以根据您的需求选择 html 或 filePath。 有关更多详细信息，请参阅使用 uvx。

</details>

<details>

<summary>使用 docker:</summary>

首先，您拉取镜像：

docker pull ychen94/mindmap-converter-mcp

其次，设置服务器：

{
  "mcpServers": {
    "mindmap-converter": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-v", "/path/to/output/folder:/output", "ychen94/mindmap-converter-mcp:latest"]
    }
  }
}

⚠️ 将 /path/to/output/folder 替换为您系统上的实际路径，您希望将思维导图保存在该路径中，例如 macOS 上的 /Users/username/Downloads 或 Windows 上的 C:\\Users\\username\\Downloads。

docker 容器中提供的工具 该服务器提供以下 MCP 工具：

1. markdown-to-mindmap-content 将 Markdown 转换为 HTML 思维导图并返回整个 HTML 内容。 您不需要在命令 docker 中使用 args: -v 和 /path/to/output/folder:/output。 参数： • markdown (string, 必需): 要转换的 Markdown 内容 • toolbar (boolean, 可选): 是否显示工具栏（默认：true） 最适合：HTML 内容大小不是问题的简单思维导图。 您可以使用 AI 客户端中的 artifact 来预览思维导图。
2. markdown-to-mindmap-file 将 Markdown 转换为 HTML 思维导图并将其保存到挂载目录中的文件中。 参数： • markdown (string, 必需): 要转换的 Markdown 内容 • filename (string, 可选): 自定义文件名（默认：自动生成的时间戳名称） • toolbar (boolean, 可选): 是否显示工具栏（默认：true） 最适合：复杂的思维导图或当您想节省 tokens 以供以后使用时。 您可以在浏览器中打开 html 文件以查看思维导图。 此外，您可以使用 iterm-mcp-server 或其他终端的 mcp 服务器在浏览器中打开文件，而不会中断您的工作流程。

</details>

故障排除

找不到文件 如果您的思维导图文件无法访问： 1 检查您是否已正确将卷挂载到 Docker 容器 2 确保路径格式对于您的操作系统是正确的 3 确保 Docker 具有访问该目录的权限

找不到 Docker 命令 1 验证 Docker 是否已安装并在您的 PATH 中 2 尝试使用 Docker 的绝对路径

服务器未出现在 Claude 中 1 在配置更改后重新启动 Claude for Desktop 2 检查 Claude 日志中是否存在连接错误 3 验证 Docker 是否正在运行

高级用法 与其他 MCP 客户端一起使用 此服务器适用于任何 MCP 兼容的客户端，而不仅仅是 Claude for Desktop。 该服务器实现了模型上下文协议 (MCP) 1.0 版规范。

注意

三种安装方法已在 macOS 和 Linux 上成功测试。

对于在 Windows 上使用 npx 进行此 MCP 时遇到问题的用户，请考虑使用 Docker 方法。 或者，如果您使用 Visual Studio Code，则 "Markmap" 扩展提供了一种可能比导航命令行工具更简单的解决方案。

特性

此服务器提供了一个使用 markmap-cli 库将 Markdown 内容转换为思维导图的工具：

• 将 Markdown 转换为交互式思维导图 HTML
• 可选择创建离线思维导图
• 可选择隐藏工具栏
• 返回 HTML 内容或文件路径

示例

在 Claude 中，您可以问：

"使用思维导图工具，为以下 markdown 代码提供一个思维导图：

# 项目规划
## 研究
### 市场分析
### 竞争对手审查
## 设计
### 线框图
### 模型
## 开发
### 前端
### 后端
## 测试
### 单元测试
### 用户测试

"

如果您想将思维导图保存到一个文件，然后使用 iTerm MCP 服务器在浏览器中打开它：

"使用思维导图工具为以下 markdown input_code 提供一个思维导图， 之后，使用 iterm 打开生成的 html 文件。 input_code:

markdown content

"

"思考一下把大象放进冰箱的过程，并提供一个思维导图。用终端打开它。"

<details>

<summary>查看结果</summary>

</details>

还有更多

许可证

本项目根据 MIT 许可证获得许可。 有关更多详细信息，请参阅此项目存储库中的 LICENSE 文件

---

如果这个项目对您有帮助，请考虑给它一个 Star ⭐️

技术的进步应该使所有人受益，而不是剥削大众。