Xmind Mind Maps

🚀 MCP XMind Server

A Model Context Protocol server for analyzing and querying XMind mind maps. This tool offers powerful functions for searching, extracting, and analyzing the content of XMind files.

✨ Features

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

📦 Installation

Installation via Smithery

To automatically install the XMind Server for the Claude desktop version through 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 Examples

Starting the Server

node dist/index.js <Allowed directories> [Other directories...]

Available Tools

1. read_xmind
   • Parse and analyze XMind files.
   • Extract the complete mind map structure.
2. get_todo_tasks
   • Extract and analyze TODO tasks.
   • Include task context and hierarchy.
3. list_xmind_directory
   • Recursively scan XMind files.
   • Filter and organize the results.
4. read_multiple_xmind_files
   • Process multiple files simultaneously.
   • Compare and analyze the content between files.
5. search_xmind_files
   • Search for files based on name patterns.
   • Recursively scan directories.
6. extract_node
   • Intelligent fuzzy path matching.
   • Rank search results.
   • Extract the complete subtree.
7. extract_node_by_id
   • Access nodes directly by ID.
   • Quick and precise retrieval.
8. search_nodes
   • Multi-criteria content search.
   • Configurable search fields.

Basic Usage

Searching for Nodes

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

Extracting Nodes

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

Listing Tasks

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

📚 Documentation

Development Configuration

Example claude_desktop_config.json for development:

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

Production Configuration

Example claude_desktop_config.json for production:

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

🔧 Technical Details

• Secure Directory Access: Ensure the security of file operations by restricting access to specified directories.

Installing Dependencies

Install project dependencies using npm or yarn:

npm install
# or
yarn install

Running Tests

Run project tests:

npm test
# or
yarn test

Packaging

Generate a production build:

npm run build
# or
yarn build