Mcp Xmind Server

Overview

What is mcp-xmind?

mcp-xmind is a public repository hosted on GitHub, created by the user apeyroux. This repository is designed to facilitate the use of XMind, a popular mind mapping and brainstorming tool. The project aims to provide users with enhanced functionalities and features that improve their experience while using XMind for organizing thoughts, ideas, and projects.

Features of mcp-xmind

User-Friendly Interface: mcp-xmind offers a clean and intuitive interface that makes it easy for users to navigate and utilize its features effectively.
Enhanced Mind Mapping Tools: The repository includes advanced tools for creating and managing mind maps, allowing users to visualize their ideas more clearly.
Collaboration Features: Users can collaborate in real-time, making it easier to work on projects with team members or share ideas with others.
Cross-Platform Compatibility: mcp-xmind is designed to work seamlessly across different operating systems, ensuring that users can access their mind maps from any device.
Customizable Templates: The repository provides a variety of templates that users can customize to fit their specific needs, making it easier to get started with mind mapping.

How to Use mcp-xmind

Access the Repository: Visit the mcp-xmind GitHub page to access the project files and documentation.
Clone the Repository: Use Git to clone the repository to your local machine by running the command:
```
git clone https://github.com/apeyroux/mcp-xmind.git
```
Install Dependencies: Follow the installation instructions provided in the repository's README file to set up any necessary dependencies.
Start Using the Application: Launch the application and begin creating your mind maps using the available tools and features.
Collaborate and Share: Invite team members to collaborate on your mind maps and share your projects with others for feedback and input.

Frequently Asked Questions

Q: Is mcp-xmind free to use?

A: Yes, mcp-xmind is a public repository and is free to use for anyone interested in mind mapping.

Q: Can I contribute to the mcp-xmind project?

A: Absolutely! Contributions are welcome. You can fork the repository, make your changes, and submit a pull request for review.

Q: What platforms does mcp-xmind support?

A: mcp-xmind is designed to be cross-platform, meaning it can be used on Windows, macOS, and Linux operating systems.

Q: Where can I find support if I encounter issues?

A: You can check the issues section of the mcp-xmind GitHub repository for existing problems or report a new issue if you need assistance.

Details

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

read_xmind
- Parse and analyze XMind files
- Extract complete mind map structure
get_todo_tasks
- Extract and analyze TODO tasks
- Include task context and hierarchy
list_xmind_directory
- Recursively scan for XMind files
- Filter and organize results
read_multiple_xmind_files
- Process multiple files simultaneously
- Compare and analyze across files
search_xmind_files
- Search files by name patterns
- Recursive directory scanning
extract_node
- Smart fuzzy path matching
- Ranked search results
- Complete subtree extraction
extract_node_by_id
- Direct node access by ID
- Fast and precise retrieval
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

{ "mcpServers": { "mcp-xmind": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/metorial/mcp-container--apeyroux--mcp-xmind--mcp-xmind", "node dist/index.js" ], "env": {} } } }