Mcp Xmind Server

Cos'è mcp-xmind?

mcp-xmind è un repository pubblico ospitato su GitHub, creato dall'utente apeyroux. Questo repository è progettato per facilitare l'uso di XMind, un popolare strumento di mappatura mentale e brainstorming. Il progetto mira a fornire agli utenti funzionalità e caratteristiche migliorate che migliorano la loro esperienza nell'utilizzo di XMind per organizzare pensieri, idee e progetti.

Caratteristiche di mcp-xmind

• Interfaccia Facile da Usare: mcp-xmind offre un'interfaccia pulita e intuitiva che rende facile per gli utenti navigare e utilizzare le sue funzionalità in modo efficace.
• Strumenti Avanzati di Mappatura Mentale: Il repository include strumenti avanzati per creare e gestire mappe mentali, consentendo agli utenti di visualizzare le loro idee in modo più chiaro.
• Funzionalità di Collaborazione: Gli utenti possono collaborare in tempo reale, rendendo più facile lavorare su progetti con membri del team o condividere idee con altri.
• Compatibilità Multi-Piattaforma: mcp-xmind è progettato per funzionare senza problemi su diversi sistemi operativi, garantendo che gli utenti possano accedere alle loro mappe mentali da qualsiasi dispositivo.
• Modelli Personalizzabili: Il repository fornisce una varietà di modelli che gli utenti possono personalizzare per soddisfare le loro esigenze specifiche, facilitando l'inizio della mappatura mentale.

Come Usare mcp-xmind

1. Accedi al Repository: Visita la pagina GitHub di mcp-xmind per accedere ai file del progetto e alla documentazione.
2. Clona il Repository: Usa Git per clonare il repository sul tuo computer locale eseguendo il comando:

   git clone https://github.com/apeyroux/mcp-xmind.git
   

3. Installa le Dipendenze: Segui le istruzioni di installazione fornite nel file README del repository per configurare eventuali dipendenze necessarie.
4. Inizia a Usare l'Applicazione: Avvia l'applicazione e inizia a creare le tue mappe mentali utilizzando gli strumenti e le funzionalità disponibili.
5. Collabora e Condividi: Invita i membri del team a collaborare sulle tue mappe mentali e condividi i tuoi progetti con altri per feedback e input.

Domande Frequenti

D: mcp-xmind è gratuito da usare?

R: Sì, mcp-xmind è un repository pubblico ed è gratuito per chiunque sia interessato alla mappatura mentale.

D: Posso contribuire al progetto mcp-xmind?

R: Assolutamente! Le contribuzioni sono benvenute. Puoi forkare il repository, apportare le tue modifiche e inviare una pull request per la revisione.

D: Quali piattaforme supporta mcp-xmind?

R: mcp-xmind è progettato per essere multi-piattaforma, il che significa che può essere utilizzato su sistemi operativi Windows, macOS e Linux.

D: Dove posso trovare supporto se incontro problemi?

R: Puoi controllare la sezione delle problematiche del repository GitHub di mcp-xmind per problemi esistenti o segnalare un nuovo problema se hai bisogno di assistenza.

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