MCP XMind Server

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
```\n\n### Manual Installation
```bash
npm install @modelcontextprotocol/sdk adm-zip zod
npm install --save-dev typescript @types/node
```\n\n## Usage# Starting the Server
```bash
node dist/index.js [additional-directories...]
```\n\n### 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\n\n## Examples# Search for Nodes
```json
{ "name": "search_nodes", "arguments": { "path": "/path/to/file.xmind", "query": "project", "searchIn": ["title", "notes"], "caseSensitive": false } }
```\n\n### Extract Node
```json
{ "name": "extract_node", "arguments": { "path": "/path/to/file.xmind", "searchQuery": "Feature > API" } }
```\n\n### List Tasks
```json
{ "name": "get_todo_tasks", "arguments": { "path": "/path/to/file.xmind" } }
```\n\n## Configuration# Development Configuration Example
`claude_desktop_config.json` for development:
```json
{ "xmind": { "command": "node", "args": [ "/Users/alex/Src/mcp-xmind/dist/index.js", "/Users/alex/XMind" ] } }
```\n\n### Production Configuration Example
`claude_desktop_config.json` for production using npmjs:
```json
{ "xmind": { "command": "npx", "args": [ "-y", "@41px/mcp-xmind", "/Users/alex/XMind" ] } }
```\n\n## Security
- Only allows access to specified directories
- Path normalization and validation
- Error handling for invalid access attempts\n\n## Development# Building
```bash
npm run build
```\n\n### Type Checking
```bash
npm run type-check
```\n\n### MCP Inspector
```bash
npx @modelcontextprotocol/inspector node dist/index.js /Users/alex/XMind