Yuchenssr Mindmap MCP Server

🚀 思維導圖 MCP 服務器

本項目是一個思維導圖 MCP 服務器，可支持 Markdown 到交互式思維導圖的 HTML 轉換，提供離線功能選項，還能隱藏工具欄，支持返回 HTML 內容或文件路徑兩種模式。

🚀 快速開始

你可以根據自己的需求，選擇合適的安裝方式來部署思維導圖 MCP 服務器。

📦 安裝指南

使用 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
   

💻 使用示例

基礎用法

在終端中運行以下命令啟動服務器：

mindmap-server start

或者指定配置文件：

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

高級用法

作為服務運行

設置為後臺服務：

mindmap-server run

其他 MCP 客戶端使用

此服務器與任何符合 MCP 協議的客戶端兼容，支持以下命令：

mcp --server mindmap --help

API 調用示例

通過 HTTP 請求調用：

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

📚 詳細文檔

配置選項

編輯 config.json 文件，添加以下內容：

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

示例用法

在 Claude Desktop 中輸入以下內容： 1.

生成以下 Markdown 代碼的思維導圖：
# 項目計劃
## 研究
### 市場分析
### 競爭對手分析
## 設計
### 界面草圖
### 模板設計
## 開發
### 前端開發
### 後端開發
## 測試
### 單元測試
### 用戶測試

將以下 Markdown 內容轉換為思維導圖，並使用終端工具打開。
Markdown 內容：
# 核心概念
## 數據結構
### 數組
### 對象
## 算法
### 排序算法
### 搜索算法
## 設計模式
### 例模式
### 工廠模式

思考將大象放入冰箱的過程，並生成一個思維導圖。然後通過終端打開。

故障排除

• 文件未找到：

  • 確保 Docker 容器已正確掛載卷
  • 檢查路徑格式是否正確
  • 確認 Docker 對目錄有權限訪問

• Docker 命令未識別：

  • 驗證 Docker 是否安裝並添加到 PATH
  • 嘗試使用 Docker 的絕對路徑

• 服務器未在 Claude 中顯示：

  • 重啟 Claude Desktop 軟件
  • 檢查日誌中的連接錯誤
  • 確認 Docker 正常運行

✨ 主要特性

• 支持 Markdown 到交互式思維導圖的 HTML 轉換
• 提供離線功能選項
• 可隱藏工具欄
• 返回 HTML 內容或文件路徑兩種模式

📄 許可證

本項目遵循 MIT 許可證，具體內容請參考 項目倉庫 中的 LICENSE 文件。

感謝您的支持與使用！如果需要幫助，請隨時聯繫維護團隊。