Mindmap MCP Server

🚀 Mindmap MCP 服務器

Mindmap MCP 服務器是一個藉助 markmap-cli 庫的工具，它能在 Model Context Protocol (MCP) 協議下，把 Markdown 轉換為互動式思維導圖 HTML。該服務器遵循 MCP 協議版本 1.0 規範，為用戶提供便捷的思維導圖生成服務。

🚀 快速開始

本服務器支持多種安裝方式，你可以根據自己的需求進行選擇。

✨ 主要特性

• 將 Markdown 轉換為互動式思維導圖 HTML
• 支持生成離線可用的思維導圖
• 可選隱藏工具欄功能
• 返回 HTML 內容或文件路徑兩種模式

📦 安裝指南

方法一：本地安裝

# 使用 npm 包管理器進行全局安裝
npm install -g markmap-cli

# 安裝此 MCP 服務器項目
git clone https://github.com/YuChenSSR/mindmap-mcp-server.git
cd mindmap-mcp-server
npm install

方法二：Docker 安裝

docker pull yuchen/mindmap-mcp-server:latest

# 啟動容器，映射端口到 3000
docker run -p 3000:3000 yuchen/mindmap-mcp-server:latest

方法三：Windows 用戶推薦

如果在 Windows 上使用 markmap-cli 出現問題，請考慮以下方法：

1. 使用 Docker 安裝（推薦）
2. 安裝 Visual Studio Code 並使用 Markmap 插件

💻 使用示例

基礎用法

配置到 Claude 桌面版

1. 打開 ~/.config/claude/settings.json 文件
2. 添加以下配置：

   "mcpServers": [
     {
       "name": "mindmap-server",
       "url": "http://localhost:3000"
     }
   ]
   

3. 重啟 Claude 桌面應用程序

其他 MCP 客戶端使用

此服務器與所有符合 MCP 協議的客戶端兼容，支持通過標準 API 進行交互。

高級用法

在 Claude 中執行以下對話

請求生成思維導圖

給我一個用於展示以下 Markdown 代碼的思維導圖，使用思維導圖工具：
# 項目計劃
## 研究
### 市場分析
### 競爭對手審查
## 設計
### 線框圖
### 模板

請求保存並打開文件

使用思維導圖工具將以下 Markdown 內容轉換為思維導圖，然後用終端打開生成的 HTML 文件。
輸入內容：
<粘貼你的 Markdown 代碼>

動態思考過程

想象一下如何將一頭大象放進冰箱，並提供一個思維導圖。在終端中打開它。

📚 詳細文檔

注意事項

⚠️ 重要提示

• 已成功測試適用於 macOS 和 Linux 系統的三種安裝方法。
• Windows 用戶若遇 npx 問題，建議使用 Docker 或 Visual Studio Code 的 Markmap 插件。

故障排除指南

1. 文件未找到

• 症狀：服務器返回 404 錯誤，提示文件不存在。
• 解決方法：
  • 檢查目標路徑是否正確。
  • 確保生成的文件名與請求的一致。

2. Docker 命令未識別

• 症狀：輸入 docker 命令時系統提示命令未找到。
• 解決方法：
  • 安裝並配置 Docker 環境。
  • 將 Docker 添加到系統 PATH 變量中。

3. 端口衝突問題

• 症狀：啟動服務器時報錯，端口被佔用。
• 解決方法：
  • 停止正在使用該端口的進程。
  • 或者修改服務器配置，使用不同的端口號（如 3001）。

高級用法

批量處理

可以將多個 Markdown 文件批量轉換為思維導圖，並通過 API 進行管理。

自定義樣式

支持通過 CSS 定製生成的 HTML 頁面樣式，具體方法請參考 markmap-cli 文檔。

貢獻指南

歡迎提交 Pull Request 或 Issues，共同完善此項目！

📄 許可證

項目遵循 MIT 開源協議，詳情請見 LICENSE 文件。