Servidor MCP de MindManager

Una implementación de servidor de Protocolo de contexto de modelo (MCP) para la biblioteca mindm , que proporciona una interfaz estandarizada para interactuar con MindManager en Windows y macOS.

Descripción general

Este servidor permite interactuar programáticamente con MindManager mediante el Protocolo de Contexto de Modelo (MCP), una forma estandarizada de proporcionar contexto y herramientas a los LLM. Utiliza la biblioteca mindm para manipular documentos, temas, relaciones y otros elementos de mapas mentales de MindManager.

Ejemplo:

Características

Recuperar la estructura del mapa mental y los temas centrales
Exportar mapas mentales a formatos Mermaid, Markdown y JSON para usarlos en los chats de LLM
Obtenga información sobre la instalación de MindManager y las carpetas de la biblioteca
Obtenga la selección actual de MindManager

Funciones planificadas

Crear nuevos mapas mentales a partir de datos serializados
Agregar, modificar y manipular temas y subtemas
Agregar relaciones entre temas
Agregar etiquetas a los temas
Establecer imágenes de fondo del documento

Requisitos

Python 3.12 o superior
Paquete mcp (SDK del protocolo de contexto de modelo)
Biblioteca mindm (incluida en este proyecto)
MindManager (versiones compatibles: 23-) instalado en Windows o macOS

Instalación macOS

# Clone the repository (if you're using it from a repository)
git clone https://github.com/robertZaufall/mindm-mcp.git
cd mindm-mcp

# create a virtual environment for Python
brew install uv # if needed
uv pip install -r pyproject.toml

# alternative: manual installation of modules
uv add "mcp[cli]"
uv add fastmcp
uv add markdown-it-py
uv add -U --index-url=https://test.pypi.org/simple/ --extra-index-url=https://pypi.org/simple/ mindm mindm-mcp

Instalación de Windows

# Change to DOS command prompt
cmd

# Clone the repository (if you're using it from a repository)
git clone https://github.com/robertZaufall/mindm-mcp.git
cd mindm-mcp

# create a virtual environment for Python
pip install uv # if needed
uv pip install -r pyproject.toml

# install nodejs
choco install nodejs # if you have chocolatey installed. If not install nodejs otherwise
refreshenv
node -v
npm install -g npx

Uso

Inspector de MCP

# run mcp with inspector
uv run --with mind --with fastmcp --with markdown-it-py mcp dev mindm_mcp/server.py

Escritorio de Claude

Archivo local de Python

Ajuste la ruta del archivo local según sea necesario.

{
  "mcpServers": {
    "mindm (MindManager)": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mindm>=0.0.4.6",
        "--with",
        "fastmcp",
        "--with",
        "markdown-it-py",
        "/Users/master/git/mindm-mcp/mindm_mcp/server.py"
      ]
    }
  }
}

Módulo del repositorio de paquetes

Ajuste VIRTUAL_ENV según sea necesario.

{
    "mcpServers": {
      "mindm (MindManager)": {
        "command": "uv",
        "args": [
          "run",
          "--with",
          "mindm>=0.0.4.6",
          "--with",
          "mindm-mcp>=0.0.1.50",
          "--with",
          "fastmcp",
          "--with",
          "markdown-it-py",
          "-m",
          "mindm_mcp.server"
        ],
        "env": {
            "VIRTUAL_ENV": "/Users/master/git/mindm-mcp/.venv"
        }
      }
    }
}

Sugerencia: si el servidor MCP no aparece con el ícono de martillo en Windows, cierre Claude Desktop y elimine todos los procesos en segundo plano.

Herramientas MCP

El servidor expone las siguientes herramientas a través del Protocolo de Contexto de Modelo:

Interacción de documentos

get_mindmap : recupera la estructura del mapa mental actual de MindManager
get_selection : recupera los temas seleccionados actualmente en MindManager
get_library_folder : obtiene la ruta a la carpeta de la biblioteca de MindManager
get_grounding_information : extrae información de conexión a tierra (tema central, subtemas seleccionados) del mapa mental

Publicación por entregas

serialize_current_mindmap_to_mermaid : serializa el mapa mental cargado actualmente en formato Mermaid
serialize_current_mindmap_to_markdown : serializa el mapa mental cargado actualmente en formato Markdown
serialize_current_mindmap_to_json : serializa el mapa mental cargado actualmente en un objeto JSON detallado con mapeo de ID

Soporte de plataforma

Windows : Soporte completo para temas, notas, íconos, imágenes, etiquetas, enlaces, relaciones y formato RTF
macOS : Compatibilidad con temas, notas y relaciones (compatibilidad limitada en comparación con Windows)

Integración con Claude y otros LLM

Este servidor MCP se puede instalar en Claude Desktop u otras aplicaciones compatibles con MCP, lo que permite a los LLM:

Acceder al contenido del mapa mental
Manipular mapas mentales (próximamente)
Crea nuevos mapas mentales basados en contenido generado por LLM (próximamente)

Solución de problemas

Asegúrese de que MindManager se esté ejecutando antes de iniciar el servidor
Para macOS, asegúrese de permitir que Claude Desktop automatice MindManager

Expresiones de gratitud

Este proyecto se basa en la biblioteca mindm , que proporciona interfaces de Python para MindManager en plataformas Windows y macOS. Utiliza el SDK del Protocolo de Contexto de Modelo (MCP) desarrollado por Anthropic.

Licencia

Licencia MIT: consulte el archivo de LICENCIA para obtener más detalles

MindManager MCP Server

Integrations