MCP XMind Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Supports distribution and installation through npm, allowing users to easily install and run the MCP server using npx commands.

  • Utilizes TypeScript for type safety in development, with specific support for type checking when building or modifying the MCP server.

  • Incorporates Zod for schema validation, ensuring proper data structure when processing XMind files and handling user queries.

Servidor MCP XMind

Un servidor de Protocolo de Contexto de Modelo para analizar y consultar mapas mentales de XMind. Esta herramienta ofrece potentes funciones para buscar, extraer y analizar contenido de archivos de XMind.

Características

  • 🔍 Búsqueda difusa inteligente en mapas mentales
  • 📝 Gestión y seguimiento de tareas
  • 🌲 Navegación jerárquica de contenido
  • 🔗 Extracción de enlaces y referencias
  • 📊 Análisis de múltiples archivos
  • 🏷️ Soporte para etiquetas y rótulos
  • 📂 Escaneo de directorios
  • 🔒 Acceso seguro al directorio

Instalación

Instalación mediante herrería

Para instalar XMind Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @41px/mcp-xmind --client claude

Instalación manual

npm install @modelcontextprotocol/sdk adm-zip zod npm install --save-dev typescript @types/node

Uso

Iniciando el servidor

node dist/index.js <allowed-directory> [additional-directories...]

Herramientas disponibles

  1. leer_xmind
    • Analizar y analizar archivos XMind
    • Extraer la estructura completa del mapa mental
  2. obtener_tareas_todo
    • Extraer y analizar tareas TODO
    • Incluir contexto y jerarquía de tareas
  3. lista_directorio_xmind
    • Escanear recursivamente archivos XMind
    • Filtrar y organizar los resultados
  4. leer múltiples archivos xmind
    • Procesar varios archivos simultáneamente
    • Comparar y analizar entre archivos
  5. buscar_archivos_xmind
    • Buscar archivos por patrones de nombre
    • Escaneo recursivo de directorios
  6. extraer_nodo
    • Coincidencia inteligente de rutas difusas
    • Resultados de búsqueda clasificados
    • Extracción completa del subárbol
  7. extraer_nodo_por_id
    • Acceso directo al nodo mediante ID
    • Recuperación rápida y precisa
  8. nodos de búsqueda
    • Búsqueda de contenido con múltiples criterios
    • Campos de búsqueda configurables

Ejemplos

Buscar nodos

{ "name": "search_nodes", "arguments": { "path": "/path/to/file.xmind", "query": "project", "searchIn": ["title", "notes"], "caseSensitive": false } }

Extraer nodo

{ "name": "extract_node", "arguments": { "path": "/path/to/file.xmind", "searchQuery": "Feature > API" } }

Lista de tareas

{ "name": "get_todo_tasks", "arguments": { "path": "/path/to/file.xmind" } }

Configuración

Configuración de desarrollo

Ejemplo claude_desktop_config.json para desarrollo:

{ "xmind": { "command": "node", "args": [ "/Users/alex/Src/mcp-xmind/dist/index.js", "/Users/alex/XMind" ] } }

Configuración de producción

Ejemplo claude_desktop_config.json para producción usando npmjs:

{ "xmind": { "command": "npx", "args": [ "-y", "@41px/mcp-xmind", "/Users/alex/XMind" ] } }

Seguridad

  • Sólo permite el acceso a directorios específicos
  • Normalización y validación de rutas
  • Manejo de errores para intentos de acceso no válidos

Desarrollo

Edificio

npm run build

Comprobación de tipos

npm run type-check

Inspector de MCP

npx @modelcontextprotocol/inspector node dist/index.js /Users/alex/XMind
-
security - not tested
F
license - not found
-
quality - not tested

Un servidor de protocolo de contexto de modelo que permite el análisis y la consulta inteligente de mapas mentales de XMind, proporcionando capacidades para buscar, extraer y analizar contenido en archivos de XMind.

  1. Features
    1. Installation
      1. Installing via Smithery
      2. Manual Installation
    2. Usage
      1. Starting the Server
      2. Available Tools
    3. Examples
      1. Search for Nodes
      2. Extract Node
      3. List Tasks
    4. Configuration
      1. Development Configuration
      2. Production Configuration
    5. Security
      1. Development
        1. Building
        2. Type Checking
        3. MCP Inspector
      ID: 4i3g9okcvy