Mcp Xmind 伺服器

什麼是 mcp-xmind？

mcp-xmind 是一個托管在 GitHub 上的公共倉庫，由用戶 apeyroux 創建。這個倉庫旨在促進 XMind 的使用，XMind 是一個流行的思維導圖和頭腦風暴工具。該項目的目標是為用戶提供增強的功能和特性，以改善他們在使用 XMind 組織思想、想法和項目時的體驗。

mcp-xmind 的特點

• 友好的用戶界面：mcp-xmind 提供了一個乾淨且直觀的界面，使得用戶能夠輕鬆導航並有效利用其功能。
• 增強的思維導圖工具：該倉庫包含先進的工具，用於創建和管理思維導圖，使用戶能夠更清晰地可視化他們的想法。
• 協作功能：用戶可以實時協作，使得與團隊成員共同工作或與他人分享想法變得更加容易。
• 跨平台兼容性：mcp-xmind 設計為能夠在不同操作系統上無縫運行，確保用戶可以從任何設備訪問他們的思維導圖。
• 可自定義模板：該倉庫提供多種模板，用戶可以根據自己的具體需求進行自定義，使得開始思維導圖變得更加簡單。

如何使用 mcp-xmind

1. 訪問倉庫：訪問 mcp-xmind GitHub 頁面 以訪問項目文件和文檔。
2. 克隆倉庫：使用 Git 將倉庫克隆到本地機器，運行以下命令：

   git clone https://github.com/apeyroux/mcp-xmind.git
   

3. 安裝依賴項：按照倉庫 README 文件中提供的安裝說明設置任何必要的依賴項。
4. 開始使用應用程序：啟動應用程序，並使用可用的工具和功能開始創建您的思維導圖。
5. 協作和分享：邀請團隊成員共同協作您的思維導圖，並與他人分享您的項目以獲取反饋和意見。

常見問題解答

問：mcp-xmind 是免費使用的嗎？

答：是的，mcp-xmind 是一個公共倉庫，任何對思維導圖感興趣的人都可以免費使用。

問：我可以為 mcp-xmind 項目做貢獻嗎？

答：當然可以！歡迎貢獻。您可以分叉倉庫，進行更改，並提交拉取請求以供審核。

問：mcp-xmind 支持哪些平台？

答：mcp-xmind 設計為跨平台，意味著它可以在 Windows、macOS 和 Linux 操作系統上使用。

問：如果遇到問題，我可以在哪裡尋求支持？

答：您可以查看 mcp-xmind GitHub 倉庫的問題部分，以了解現有問題或報告新問題以獲取幫助。

MCP XMind Server

A Model Context Protocol server for analyzing and querying XMind mind maps. This tool provides powerful capabilities for searching, extracting, and analyzing content from XMind files.

Features

• 🔍 Smart fuzzy search across mind maps
• 📝 Task management and tracking
• 🌲 Hierarchical content navigation
• 🔗 Link and reference extraction
• 📊 Multi-file analysis
• 🏷️ Label and tag support
• 📂 Directory scanning
• 🔒 Secure directory access

Installation

Installing via Smithery

To install XMind Server for Claude Desktop automatically via Smithery:

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

Manual Installation

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

Usage

Starting the Server

node dist/index.js <allowed-directory> [additional-directories...]

Available Tools

1. read_xmind

   • Parse and analyze XMind files
   • Extract complete mind map structure

2. get_todo_tasks

   • Extract and analyze TODO tasks
   • Include task context and hierarchy

3. list_xmind_directory

   • Recursively scan for XMind files
   • Filter and organize results

4. read_multiple_xmind_files

   • Process multiple files simultaneously
   • Compare and analyze across files

5. search_xmind_files

   • Search files by name patterns
   • Recursive directory scanning

6. extract_node

   • Smart fuzzy path matching
   • Ranked search results
   • Complete subtree extraction

7. extract_node_by_id

   • Direct node access by ID
   • Fast and precise retrieval

8. search_nodes

   • Multi-criteria content search
   • Configurable search fields

Examples

Search for Nodes

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

Extract Node

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

List Tasks

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

Configuration

Development Configuration

Example claude_desktop_config.json for development:

{
  "xmind": {
    "command": "node",
    "args": [
      "/Users/alex/Src/mcp-xmind/dist/index.js",
      "/Users/alex/XMind"
    ]
  }
}

Production Configuration

Example claude_desktop_config.json for production using npmjs:

{
  "xmind": {
    "command": "npx",
    "args": [
      "-y",
      "@41px/mcp-xmind",
      "/Users/alex/XMind"
    ]
  }
}

Security

• Only allows access to specified directories
• Path normalization and validation
• Error handling for invalid access attempts

Development

Building

npm run build

Type Checking

npm run type-check

MCP Inspector

npx @modelcontextprotocol/inspector node dist/index.js /Users/alex/XMind