MindNode MCP Server

Подключите MindNode к Claude и любому ИИ-агенту — MCP-сервер для приложения для создания интеллект-карт, у которого нет ни API, ни AppleScript, ни экспортируемых файлов.

MindNode Next (поколение MindNode 2024+) перенёс все документы в приватную библиотеку SQLite/CRDT и поставляется с нулевой поверхностью автоматизации: ни словаря AppleScript, ни CLI, ни облачного API, даже .mindnode-файлов на диске больше нет. Этот проект реконструировал формат хранения, чтобы ИИ-агенты наконец могли читать и создавать интеллект-карты:

• Читать любую интеллект-карту как Markdown-структуру — прямо из локальной библиотеки MindNode (SQLite → protobuf → Apple LZ4 → CRDT decode), только для чтения, даже не запуская приложение.

• Видеть точное отображение карты — собственные JPEG-превью MindNode, попиксельно точные.

• Создавать новые интеллект-карты из Markdown-структур (тихий импорт внутри приложения).

• Открывать любую карту по имени через URL-схему mindnode://.

Работает с Claude Code, Claude Desktop и любым MCP-клиентом.

Ищете классический файловый MindNode? Более старые инструменты на основе plist работают с .mindnode-документами; этот сервер предназначен для MindNode Next (2024+), поколения с SQLite-библиотекой, где эти подходы больше не работают. Проверено на MindNode 2026.4.4.

Инструменты

Установка

Требуется macOS с MindNode 2024+ и Node.js ≥ 24.

Claude Code:

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

Claude Desktop / любой MCP-клиент (claude_desktop_config.json):

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

Из исходников (Node ≥ 24 запускает TypeScript напрямую, без шага сборки):

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

Отладка с помощью MCP-инспектора: npm run inspect.

Как я это использую

Я веду ежедневную интеллект-карту (одну на день, плюс карты по проектам) как рабочую память — Raycast настроен так, чтобы вызывать MindNode одним нажатием клавиши, поэтому зафиксировать мысль ничего не стоит. Этот сервер замыкает цикл: в конце дня агент читает карту, превращает её в рабочий журнал или черновик блога и может наполнить завтрашнюю карту из открытых тем. Спрашивайте Claude, например:

• "список моих интеллект-карт"

• "прочитай сегодняшнюю карту и составь обновление для стендапа"

• "преврати эту структуру в интеллект-карту: …"

Как это работает

MindNode Next хранит всё в библиотеке GRDB/SQLite внутри своего sandbox-контейнера. Каждый документ — это protobuf базовый снимок плюс поток CRDT пакетов операций, оба обёрнуты в крошечный конверт (поле 12345 = версия, поле 678910 = полезная нагрузка — да, именно так) и сжаты с помощью фрейминга Apple LZ4 (блоки bv41/bv4-/bv4$).

В этом репозитории есть парсер protobuf без схемы, декодер Apple-LZ4 на чистом TypeScript и реконструктор дерева, который воспроизводит операции создания узлов и текстовые операции. Полные заметки по обратной разработке находятся в docs/FORMAT.md — если хотите создать собственный инструментарий для MindNode, начните там. tools/spelunk.py красиво выводит любой библиотечный blob для дальнейшего изучения.

Запись намеренно не касается базы данных (она синхронизируется через CloudKit; повредить её было бы непростительно). Новые документы проходят через собственный импортёр Markdown в MindNode с помощью open -a MindNode — это тихо и без потерь.

Предостережения

• get_mindmap восстанавливает текст из потока CRDT-операций, кодировка позиций которого изучена не полностью: сильно отредактированные строки могут вернуться слегка перепутанными, а удалённые узлы могут остаться как (untitled). Используйте get_mindmap_image, когда важна точность. Документы, созданные через create_mindmap, читаются обратно без потерь.

• create_mindmap запускает MindNode (импорт происходит внутри приложения, тихо).

• Библиотека читается только для чтения, всегда. Формат проверен на MindNode 2026.4.4; будущее обновление MindNode может сдвинуть номера полей — создайте issue с выводом tools/spelunk.py, если структуры возвращаются пустыми.

Дорожная карта

• Редактирование на уровне узлов (добавление/переименование/удаление одного узла) и экспорт без потерь через 20 App Intents MindNode (CreateNode, EditNode, ExportDocument, …), обёрнутых в Shortcuts

• Разобрать кодировку позиций текста в CRDT и удаления для точного чтения

• Заголовки папок, теги/стикеры, поля заметок

Лицензия

MIT