Yuchenssr Mindmap MCP Server

🚀 思维导图 MCP 服务器

本项目是一个思维导图 MCP 服务器，支持将 Markdown 转换为交互式思维导图的 HTML，提供离线功能选项，还能隐藏工具栏，以满足多样化的使用需求。

🚀 快速开始

你可以通过以下方式启动服务器：

mindmap-server start

或者指定配置文件启动：

mindmap-server start --config ./config.json

✨ 主要特性

• 支持 Markdown 到交互式思维导图的 HTML 转换
• 提供离线功能选项
• 可隐藏工具栏
• 返回 HTML 内容或文件路径两种模式

📦 安装指南

使用 npm 安装

在终端中运行以下命令：

npm install -g @markmap/markmap-cli

克隆源码安装

1. 创建一个新目录并克隆仓库：

git clone https://github.com/YuChenSSR/mindmap-mcp-server.git
cd mindmap-mcp-server

2. 安装依赖项：

npm install

Docker 部署

1. 拉取镜像：

docker pull yuchen/mindmap-mcp-server:latest

2. 运行容器：

docker run -it --rm yuchen/mindmap-mcp-server:latest

💻 使用示例

基础用法

在 Claude Desktop 中输入以下内容，可生成思维导图：

生成以下 Markdown 代码的思维导图：
# 项目计划
## 研究
### 市场分析
### 竞争对手分析
## 设计
### 界面草图
### 模板设计
## 开发
### 前端开发
### 后端开发
## 测试
### 单元测试
### 用户测试

高级用法

在 Claude Desktop 中输入以下内容，将 Markdown 内容转换为思维导图并使用终端工具打开：

将以下 Markdown 内容转换为思维导图，并使用终端工具打开。
Markdown 内容：
# 核心概念
## 数据结构
### 数组
### 对象
## 算法
### 排序算法
### 搜索算法
## 设计模式
### 例模式
### 工厂模式

也可以输入以下内容，思考将大象放入冰箱的过程并生成思维导图，然后通过终端打开：

思考将大象放入冰箱的过程，并生成一个思维导图。然后通过终端打开。

📚 详细文档

配置选项

编辑 config.json 文件，添加以下内容：

{
  "port": 3000,
  "debug": true,
  "toolbarEnabled": true
}

故障排除

• 文件未找到：

  • 确保 Docker 容器已正确挂载卷
  • 检查路径格式是否正确
  • 确认 Docker 对目录有权限访问

• Docker 命令未识别：

  • 验证 Docker 是否安装并添加到 PATH
  • 尝试使用 Docker 的绝对路径

• 服务器未在 Claude 中显示：

  • 重启 Claude Desktop 软件
  • 检查日志中的连接错误
  • 确认 Docker 正常运行

高级用法

其他 MCP 客户端使用

此服务器与任何符合 MCP 协议的客户端兼容，支持以下命令：

mcp --server mindmap --help

API 调用示例

通过 HTTP 请求调用：

curl -X POST http://localhost:3000/mindmap \
-d '{"markdown": "## Hello World\n### Basic Usage", "toolbar": true}'

📄 许可证

本项目遵循 MIT 许可证，具体内容请参考 项目仓库 中的 LICENSE 文件。

感谢您的支持与使用！如果需要帮助，请随时联系维护团队。