Mcp Xmind Server

¿Qué es mcp-xmind?

mcp-xmind es un repositorio público alojado en GitHub, creado por el usuario apeyroux. Este repositorio está diseñado para facilitar el uso de XMind, una herramienta popular de mapas mentales y lluvia de ideas. El proyecto tiene como objetivo proporcionar a los usuarios funcionalidades y características mejoradas que mejoren su experiencia al usar XMind para organizar pensamientos, ideas y proyectos.

Características de mcp-xmind

• Interfaz Amigable: mcp-xmind ofrece una interfaz limpia e intuitiva que facilita a los usuarios navegar y utilizar sus funciones de manera efectiva.
• Herramientas Avanzadas de Mapas Mentales: El repositorio incluye herramientas avanzadas para crear y gestionar mapas mentales, permitiendo a los usuarios visualizar sus ideas con mayor claridad.
• Funciones de Colaboración: Los usuarios pueden colaborar en tiempo real, lo que facilita trabajar en proyectos con miembros del equipo o compartir ideas con otros.
• Compatibilidad Multiplataforma: mcp-xmind está diseñado para funcionar sin problemas en diferentes sistemas operativos, asegurando que los usuarios puedan acceder a sus mapas mentales desde cualquier dispositivo.
• Plantillas Personalizables: El repositorio proporciona una variedad de plantillas que los usuarios pueden personalizar para adaptarse a sus necesidades específicas, facilitando el inicio en la creación de mapas mentales.

Cómo Usar mcp-xmind

1. Accede al Repositorio: Visita la página de GitHub de mcp-xmind para acceder a los archivos del proyecto y la documentación.
2. Clona el Repositorio: Usa Git para clonar el repositorio en tu máquina local ejecutando el comando:

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

3. Instala Dependencias: Sigue las instrucciones de instalación proporcionadas en el archivo README del repositorio para configurar las dependencias necesarias.
4. Comienza a Usar la Aplicación: Inicia la aplicación y comienza a crear tus mapas mentales utilizando las herramientas y características disponibles.
5. Colabora y Comparte: Invita a miembros del equipo a colaborar en tus mapas mentales y comparte tus proyectos con otros para recibir comentarios y sugerencias.

Preguntas Frecuentes

P: ¿Es mcp-xmind gratuito para usar?

R: Sí, mcp-xmind es un repositorio público y es gratuito para cualquier persona interesada en la creación de mapas mentales.

P: ¿Puedo contribuir al proyecto mcp-xmind?

R: ¡Absolutamente! Las contribuciones son bienvenidas. Puedes bifurcar el repositorio, hacer tus cambios y enviar una solicitud de extracción para revisión.

P: ¿Qué plataformas soporta mcp-xmind?

R: mcp-xmind está diseñado para ser multiplataforma, lo que significa que se puede usar en sistemas operativos Windows, macOS y Linux.

P: ¿Dónde puedo encontrar soporte si encuentro problemas?

R: Puedes revisar la sección de problemas del repositorio de GitHub de mcp-xmind para ver problemas existentes o reportar un nuevo problema si necesitas asistencia.

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