Mcp Xmind Serveur

Qu'est-ce que mcp-xmind ?

mcp-xmind est un dépôt public hébergé sur GitHub, créé par l'utilisateur apeyroux. Ce dépôt est conçu pour faciliter l'utilisation de XMind, un outil populaire de cartographie mentale et de brainstorming. Le projet vise à fournir aux utilisateurs des fonctionnalités et des caractéristiques améliorées qui améliorent leur expérience lors de l'utilisation de XMind pour organiser des pensées, des idées et des projets.

Fonctionnalités de mcp-xmind

• Interface conviviale : mcp-xmind offre une interface claire et intuitive qui facilite la navigation et l'utilisation efficace de ses fonctionnalités.
• Outils de cartographie mentale améliorés : Le dépôt comprend des outils avancés pour créer et gérer des cartes mentales, permettant aux utilisateurs de visualiser leurs idées plus clairement.
• Fonctionnalités de collaboration : Les utilisateurs peuvent collaborer en temps réel, ce qui facilite le travail sur des projets avec des membres de l'équipe ou le partage d'idées avec d'autres.
• Compatibilité multiplateforme : mcp-xmind est conçu pour fonctionner sans problème sur différents systèmes d'exploitation, garantissant que les utilisateurs peuvent accéder à leurs cartes mentales depuis n'importe quel appareil.
• Modèles personnalisables : Le dépôt fournit une variété de modèles que les utilisateurs peuvent personnaliser pour répondre à leurs besoins spécifiques, facilitant ainsi le démarrage de la cartographie mentale.

Comment utiliser mcp-xmind

1. Accéder au dépôt : Visitez la page GitHub de mcp-xmind pour accéder aux fichiers du projet et à la documentation.
2. Cloner le dépôt : Utilisez Git pour cloner le dépôt sur votre machine locale en exécutant la commande :

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

3. Installer les dépendances : Suivez les instructions d'installation fournies dans le fichier README du dépôt pour configurer les dépendances nécessaires.
4. Commencer à utiliser l'application : Lancez l'application et commencez à créer vos cartes mentales en utilisant les outils et fonctionnalités disponibles.
5. Collaborer et partager : Invitez des membres de l'équipe à collaborer sur vos cartes mentales et partagez vos projets avec d'autres pour obtenir des retours et des suggestions.

Questions Fréquemment Posées

Q : mcp-xmind est-il gratuit à utiliser ?

R : Oui, mcp-xmind est un dépôt public et est gratuit à utiliser pour quiconque s'intéresse à la cartographie mentale.

Q : Puis-je contribuer au projet mcp-xmind ?

R : Absolument ! Les contributions sont les bienvenues. Vous pouvez forker le dépôt, apporter vos modifications et soumettre une demande de tirage pour révision.

Q : Quelles plateformes mcp-xmind prend-il en charge ?

R : mcp-xmind est conçu pour être multiplateforme, ce qui signifie qu'il peut être utilisé sur les systèmes d'exploitation Windows, macOS et Linux.

Q : Où puis-je trouver de l'aide si je rencontre des problèmes ?

R : Vous pouvez consulter la section des problèmes du dépôt GitHub de mcp-xmind pour des problèmes existants ou signaler un nouveau problème si vous avez besoin d'aide.

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