🚀 思维导图 MCP 服务器
本项目是一个思维导图 MCP 服务器，支持将 Markdown 转换为交互式思维导图的 HTML，提供离线功能选项，还能隐藏工具栏，以满足多样化的使用需求。
🚀 快速开始
你可以通过以下方式启动服务器：
mindmap-server start
或者指定配置文件启动：
mindmap-server start --config ./config.json
✨ 主要特性
- 支持 Markdown 到交互式思维导图的 HTML 转换
- 提供离线功能选项
- 可隐藏工具栏
- 返回 HTML 内容或文件路径两种模式
📦 安装指南
使用 npm 安装
在终端中运行以下命令：
npm install -g @markmap/markmap-cli
克隆源码安装
- 创建一个新目录并克隆仓库：
git clone https://github.com/YuChenSSR/mindmap-mcp-server.git
cd mindmap-mcp-server
- 安装依赖项：
npm install
Docker 部署
- 拉取镜像：
docker pull yuchen/mindmap-mcp-server:latest
- 运行容器：
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 文件。
感谢您的支持与使用！如果需要帮助，请随时联系维护团队。