XMind

What is MCP XMind Server?

MCP XMind Server is a Model Context Protocol (MCP) server that enables advanced analysis and querying of XMind mind map files. It allows users to search, extract, and analyze content within their XMind directories, making mind map data more accessible and manageable.

How to use MCP XMind Server?

Installation:

• Via Smithery: npx -y @smithery/cli install @41px/mcp-xmind --client claude
• Manual: npm install @modelcontextprotocol/sdk adm-zip zod followed by npm install --save-dev typescript @types/node

Starting the Server: node dist/index.js <allowed-directory> [additional-directories...]

Available Tools (Examples):

• read_xmind: Parse and analyze XMind files.
• get_todo_tasks: Extract and analyze TODO tasks from mind maps.
• list_xmind_directory: Recursively scan for XMind files.
• search_nodes: Search for nodes within XMind files based on criteria.

Key Features of MCP XMind Server

• 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

Use Cases of MCP XMind Server

• Project Management: Track tasks and progress within mind maps.
• Knowledge Management: Efficiently search and retrieve information from extensive XMind knowledge bases.
• Data Analysis: Analyze and compare content across multiple XMind files.
• Content Extraction: Extract specific nodes, links, or tasks for reporting or further processing.

FAQ about MCP XMind Server

Q: What is Model Context Protocol (MCP)? A: MCP is a protocol that allows applications to interact with and understand the context of various data sources, in this case, XMind files.

Q: How does MCP XMind Server ensure security? A: It only allows access to specified directories, employs path normalization and validation, and includes error handling for invalid access attempts.

Q: Can I use MCP XMind Server with Claude Desktop? A: Yes, installation instructions are provided for integration with Claude Desktop, both via Smithery and manual configuration.

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