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:

Related MCP server: Mermaid MCP Server

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:

1. Acceder al contenido del mapa mental

2. Manipular mapas mentales (próximamente)

3. 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