Xmind Mind Maps

🚀 MCP XMind 服務器

一個用於分析和查詢 XMind 思維導圖的 Model Context Protocol 服務器。此工具提供了強大的搜索、提取和分析 XMind 文件內容的功能，能幫助用戶高效處理思維導圖相關任務。

🚀 快速開始

MCP XMind 服務器可用於分析和查詢 XMind 思維導圖，提供強大的搜索、提取和分析功能。以下是使用前的安裝和啟動步驟。

✨ 主要特性

• 🔍 智能模糊搜索
• 📝 任務管理與跟蹤
• 🌲 層次內容導航
• 🔗 鏈接和引用提取
• 📊 多文件分析
• 🏷️ 標籤支持
• 📂 目錄掃描
• 🔒 安全目錄訪問

📦 安裝指南

通過 Smithery 安裝

要通過 Smithery 自動安裝 Claude 桌面版的 XMind Server，可使用以下命令：

npx -y @smithery/cli install @41px/mcp-xmind --client claude

手動安裝

npm install @modelcontextprotocol/sdk adm-zip zod
npm install --save-dev typescript @types/node

💻 使用示例

基礎用法

啟動服務器

node dist/index.js <允許的目錄> [其他目錄...]

可用工具

1. read_xmind
   • 解析和分析 XMind 文件
   • 提取完整的思維導圖結構
2. get_todo_tasks
   • 提取並分析 TODO 任務
   • 包含任務上下文和層次結構
3. list_xmind_directory
   • 遞歸掃描 XMind 文件
   • 過濾和組織結果
4. read_multiple_xmind_files
   • 同時處理多個文件
   • 比較和分析文件之間的內容
5. search_xmind_files
   • 根據名稱模式搜索文件
   • 遞歸目錄掃描
6. extract_node
   • 智能模糊路徑匹配
   • 排名搜索結果
   • 完整子樹提取
7. extract_node_by_id
   • 直接通過 ID 訪問節點
   • 快速精確檢索
8. search_nodes
   • 多標準內容搜索
   • 可配置搜索字段

高級用法

搜索節點

{
    "name": "search_nodes",
    "arguments": {
        "path": "/path/to/file.xmind",
        "query": "project",
        "searchIn": ["title", "notes"],
        "caseSensitive": false
    }
}

提取節點

{
    "name": "extract_node",
    "arguments": {
        "path": "/path/to/file.xmind",
        "searchQuery": "Feature > API"
    }
}

列出任務

{
    "name": "get_todo_tasks",
    "arguments": {
        "path": "/path/to/file.xmind"
    }
}

📚 詳細文檔

配置

開發配置

示例 claude_desktop_config.json 用於開發：

{
  "xmind": {
    "command": "node dist/index.js",
    "args": ["--development"]
  }
}

生產配置

示例 claude_desktop_config.json 用於生產：

{
  "xmind": {
    "command": "node dist/index.js"
  }
}

安全性

• 安全目錄訪問：通過限制對指定目錄的訪問，確保文件操作的安全性。

開發信息

安裝依賴項

使用 npm 或 yarn 安裝項目依賴：

npm install
# 或者
yarn install

運行測試

運行項目測試：

npm test
# 或者
yarn test

打包

生成生產構建：

npm run build
# 或者
yarn build