STARWARCLOUD STARWAR.AI
返回市场
思维导图-MCP服务器

思维导图-MCP服务器

作者：YuChenSSR207 星标更新：2025-05-20
安装使用来源：spider==github.com

项目介绍

思维导图 MCP 服务器

<p align="center"> <img src="https://gips3.baidu.com/it/u=1245301186,4070325384&fm=3081&app=3081&f=JPEG?w=1024&h=1024" alt="mindmap_mcp" width="50%"> </p>

一个用于将 Markdown 内容转换为交互式思维导图的 Model Context Protocol (MCP) 服务器。

安装

pip install mindmap-mcp-server

或者使用 uvx：

uvx mindmap-mcp-server

或者使用 docker 更安全且更简单。

注意事项

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

对于在使用 npx 安装此 MCP 时遇到问题的 Windows 用户，建议使用 Docker 方法。另外，如果你使用 Visual Studio Code，可以考虑使用 "Markmap" 扩展，这可能比使用命令行工具更为简单。

如果你遇到了无法解决的问题，你可以使用我的系统提示作为思维导图助手，而不是使用这个 MCP 服务器。

<details> <summary>使用我的系统提示而不是使用这个 MCP 服务器</summary> 
你是一个专门的助手，生成基于 Markdown 的交互式思维导图（markmaps）的 HTML 代码。当用户发送内容给你时，请回复一个完整的 HTML 文档，显示他们的内容作为 markmap 视觉化。
如果开启了 artifact 工具，你可以使用 artifact。

遵循以下要求：
1. 使用 markmap-autoloader 库（版本 0.18 或最新稳定版）
2. 按照下面的模板格式化 HTML
3. 将模板中的示例内容替换为用户的实际内容，并保持其层次结构
4. 维持 markmap 配置选项（maxWidth: 300, colorFreezeLevel: 2）
5. 如果用户没有提供 Markdown 格式（# 用于标题），适当格式化他们的内容，主要主题使用 #，子主题使用 ##

遵循的模板：

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Markmap</title>
    <style>
      svg.markmap {
        width: 100%;
        height: 100vh;
      }
    </style>
    <script src="https://cdn.jsdelivr.net/npm/markmap-autoloader@0.18"></script>
  </head>
  <body>
    <div class="markmap">
      <script type="text/template">
        ---
        markmap:
          maxWidth: 300
          colorFreezeLevel: 2
        ---

        # markmap

        ## Links

        - <https://markmap.js.org/>
        - [GitHub](https://github.com/markmap/markmap)

        ## Related

        - [coc-markmap](https://github.com/markmap/coc-markmap)
        - [gatsby-remark-markmap](https://github.com/markmap/gatsby-remark-markmap)

        ## Features

        - links
        - **inline** ~~text~~ *styles*
        - multiline
          text
        - `inline code`
        - Katex - $x = {-b \pm \sqrt{b^2-4ac} \over 2a}$
        - This is a very very very very very very very very very very very very very very very long line.
      </script>
    </div>
  </body>
</html>

可视化选项： （如果公式或符号显示不正确，请下载 HTML 文件并在浏览器中打开。）

  1. 在 artifacts 中查看思维导图（如果有）： system_prompt_artifact

  2. 渲染 HTML 文件作为思维导图： system_prompt_render

</details>

先决条件

当使用命令 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 中预览； return_html_content

html_preview

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

file_to_open

</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 中使用参数：-v 和 /path/to/output/folder:/output。 参数： • markdown (字符串，必需)：要转换的 Markdown 内容 • toolbar (布尔值，可选)：是否显示工具栏（默认：true） 适合于：简单的思维导图，HTML 内容大小不是问题。你还可以在 AI 客户端的 artifact 中预览思维导图。
  2. markdown-to-mindmap-file 将 Markdown 转换为 HTML 思维导图并将其保存到挂载目录中的文件。 参数： • markdown (字符串，必需)：要转换的 Markdown 内容 • filename (字符串，可选)：自定义文件名（默认：自动生成的时间戳名称） • toolbar (布尔值，可选)：是否显示工具栏（默认：true） 适合于：复杂的思维导图或当你想要保存 token 以备后用。你可以在浏览器中打开 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。服务器实现了 Model Context Protocol (MCP) 版本 1.0 规范。

功能

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

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

示例

在 Claude 中，你可以请求：

"给定以下 Markdown 代码的思维导图，使用思维导图工具：

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

"

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

"给定以下 Markdown 输入代码的思维导图，使用思维导图工具， 之后，使用 iTerm 打开生成的 HTML 文件。 输入代码：

Markdown 内容

"

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

<details> <summary>查看结果</summary>

aiworkflow

mindmapinbrowser

</details>

等等

许可

此项目采用 MIT 许可证。 更多详情，请参阅 此项目仓库 中的 LICENSE 文件

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

科技进步应当惠及所有人，而不是剥削大众。