mindmap-mcp-server 是一种基于 MCP 的开源的服务器，它将 Markdown 的内容转换为交互式思维导图，支持 HTML 和文件路径两种返回方式，能与支持 MCP 的客户端（如 Claude Desktop、Goose CLI）无缝集成，极大简化了 AI 驱动的知识可视化流程。

基础设置

1．环境依赖
需安装 Python 3.10 及以上版本用于运行该服务器，也需要预先安装 Node.js 以支持markmap-cli 工具的执行。
2．安装方式
安装pip：pip install mindmap-mcp-server
安装 uvx：uvx mindmap-mcp-server
用Docker 部署该服务器：docker pull ychen94/mindmap-converter-mcp:latest
3．配置与运行
通过—return-type 指定返回命令行参数的类型，可选择 html 或 filePath，默认为html。
使用 uvx 实现：
{ “mcpServers”: { “mindmap”: { “command”:”uvx”, “args”:[“mindmap-mcp-server”,”—return-type”,”filePath”] } }}GitHub

使用 Python 实现：
{ “mcpServers”: { “mindmap”: { “command”:”python”,”args”:[“/path/to/mindmap_mcp_server/server.py”,”—return-type”,”html”] } }}GitHub

使用 Docker 实现：
{ “mcpServers”: { “mindmap”: { “command”:”docker”, “args”:[“run”,”—rm”,”-i”,”-v”,”/本地/输出目录:/output”,”ychen94/mindmap-converter-mcp:latest”] } }}

将Markdown转换为思维导图

该脚本通过 Python 的 subprocess 模块调用已安装的 mindmap-mcp- server 命令，向 MCP 服务发送 convert_markdown_to_mindmap 工具调用请求，并根据—return-type 参数获取生成结果：当该参数为 filePath 时返回文件保存路径，用户可直接在浏览器中打开以查看交互式思维导图。
本文节选自《MCP原理与实战：高效AI Agent智能体开发》