Servidor MCP de MindNode

Conecta MindNode con Claude y cualquier agente de IA: un servidor MCP para la aplicación de mapas mentales que no tiene API, ni AppleScript, ni archivos exportables.

MindNode Next (la generación 2024+ de MindNode) movió todos los documentos a una biblioteca privada SQLite/CRDT y ofrece cero superficie de automatización: sin diccionario de AppleScript, sin CLI, sin API en la nube, ni siquiera archivos .mindnode en el disco. Este proyecto ha invertido el formato de almacenamiento para que los agentes de IA puedan finalmente leer y crear mapas mentales:

• Leer cualquier mapa mental como un esquema Markdown — directamente desde la biblioteca local de MindNode (SQLite → protobuf → Apple LZ4 → decodificación CRDT), de solo lectura, sin siquiera abrir la aplicación.

• Ver el mapa renderizado exacto — las vistas previas JPEG propias de MindNode, con precisión de píxeles.

• Crear nuevos mapas mentales a partir de esquemas Markdown (importación silenciosa en la aplicación).

• Abrir cualquier mapa por nombre mediante el esquema de URL mindnode://.

Funciona con Claude Code, Claude Desktop y cualquier cliente MCP.

¿Buscas el MindNode clásico basado en archivos? Las herramientas más antiguas basadas en plist cubren los documentos .mindnode; este servidor es para MindNode Next (2024+), la generación de biblioteca SQLite donde esos enfoques ya no funcionan. Verificado en MindNode 2026.4.4.

Herramientas

Instalación

Requiere macOS con MindNode 2024+ y Node.js ≥ 24.

Claude Code:

claude mcp add --scope user mindnode -- npx -y mindnode-mcp

Claude Desktop / cualquier cliente MCP (claude_desktop_config.json):

{
  "mcpServers": {
    "mindnode": {
      "command": "npx",
      "args": ["-y", "mindnode-mcp"]
    }
  }
}

Desde el código fuente (Node ≥ 24 ejecuta TypeScript directamente, sin paso de compilación):

git clone https://github.com/jyuwaaw/mindnode-mcp.git
cd mindnode-mcp && npm install
claude mcp add --scope user mindnode -- node /path/to/mindnode-mcp/src/index.ts

Depura con el inspector MCP: npm run inspect.

Cómo lo uso

Mantengo un mapa mental diario (uno por día, además de mapas por proyecto) como mi memoria de trabajo — Raycast está configurado para invocar MindNode con una sola pulsación de tecla, así que capturar un pensamiento no cuesta nada. Este servidor cierra el bucle: al final del día un agente lee el mapa, lo convierte en un registro de trabajo o un borrador de blog, y puede sembrar el mapa del día siguiente a partir de hilos abiertos. Pregunta a Claude cosas como:

• "lista mis mapas mentales"

• "lee el mapa de hoy y redacta una actualización de standup"

• "convierte este esquema en un mapa mental: …"

Cómo funciona

MindNode Next almacena todo en una biblioteca GRDB/SQLite dentro de su contenedor sandbox. Cada documento es una instantánea base protobuf más un flujo de lotes de operaciones CRDT, ambos envueltos en un pequeño sobre (campo 12345 = versión, campo 678910 = carga útil — sí, de verdad) y comprimidos con el marco LZ4 de Apple (bloques bv41/bv4-/bv4$).

Este repositorio incluye un analizador protobuf sin esquema, un decodificador Apple-LZ4 en TypeScript puro y un reconstructor de árbol que reproduce las operaciones de creación de nodos y de texto. Las notas completas de ingeniería inversa están en docs/FORMAT.md — si quieres construir tus propias herramientas para MindNode, empieza ahí. tools/spelunk.py imprime de forma legible cualquier blob de la biblioteca para seguir investigando.

Las escrituras deliberadamente no tocan la base de datos (está sincronizada con CloudKit; corromperla sería imperdonable). Los nuevos documentos pasan por el importador Markdown propio de MindNode mediante open -a MindNode, que es silencioso y sin pérdidas.

Advertencias

• get_mindmap reconstruye el texto a partir de un flujo de operaciones CRDT cuya codificación de posición no está completamente mapeada: las cadenas muy editadas pueden volver ligeramente desordenadas, y los nodos eliminados pueden permanecer como (sin título). Usa get_mindmap_image cuando la exactitud sea importante. Los documentos creados mediante create_mindmap se leen sin pérdidas.

• create_mindmap lanza MindNode (la importación ocurre en la aplicación, en silencio).

• La biblioteca se lee siempre en modo de solo lectura. Formato verificado en MindNode 2026.4.4; una futura actualización de MindNode podría cambiar los números de campo — abre un issue con la salida de tools/spelunk.py si los esquemas vuelven vacíos.

Hoja de ruta

• Ediciones a nivel de nodo (añadir/renombrar/eliminar un solo nodo) y exportación sin pérdidas mediante los 20 App Intents de MindNode (CreateNode, EditNode, ExportDocument, …) envueltos en Shortcuts

• Mapear la codificación de posición de texto CRDT y las eliminaciones para lecturas exactas

• Títulos de carpetas, etiquetas/pegatinas, campos de notas

Licencia

MIT