https://github.com/apeyroux/mcp-xmind
https://github.com/apeyroux/mcp-xmind
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/apeyroux/mcp-xmind
- Owner: apeyroux
- Created: 2024-12-12T14:35:09.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-12-27T20:24:06.000Z (10 months ago)
- Last Synced: 2025-08-23T21:38:57.368Z (about 2 months ago)
- Language: JavaScript
- Size: 27.3 KB
- Stars: 28
- Watchers: 2
- Forks: 6
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
- awesome-mcp-servers - XMind - Analyzes and queries XMind mind maps, enabling smart searches, task management, and multi-file analysis (Table of Contents / Knowledge and Memory)
- mcp-index - XMind Server - Analyze and query XMind mind maps using features for searching, extracting, and managing content across multiple files. Supports task management, hierarchical navigation, and secure directory access. (Task and Project Management)
README
# MCP XMind Server
[](https://smithery.ai/server/@41px/mcp-xmind)
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](https://smithery.ai/server/@41px/mcp-xmind):
```bash
npx -y @smithery/cli install @41px/mcp-xmind --client claude
```
### Manual Installation
```bash
npm install @modelcontextprotocol/sdk adm-zip zod
npm install --save-dev typescript @types/node
```
## Usage
### Starting the Server
```bash
node dist/index.js [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
```json
{
"name": "search_nodes",
"arguments": {
"path": "/path/to/file.xmind",
"query": "project",
"searchIn": ["title", "notes"],
"caseSensitive": false
}
}
```
### Extract Node
```json
{
"name": "extract_node",
"arguments": {
"path": "/path/to/file.xmind",
"searchQuery": "Feature > API"
}
}
```
### List Tasks
```json
{
"name": "get_todo_tasks",
"arguments": {
"path": "/path/to/file.xmind"
}
}
```
## 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"
]
}
}
```
### Production Configuration
Example `claude_desktop_config.json` for production using npmjs:
```json
{
"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
```bash
npm run build
```
### Type Checking
```bash
npm run type-check
```
### MCP Inspector
```bash
npx @modelcontextprotocol/inspector node dist/index.js /Users/alex/XMind
```