MindNode MCP 서버

MindNode를 Claude 및 모든 AI 에이전트에 연결하세요 — API도, AppleScript도, 내보낼 수 있는 파일도 없는 마인드 매핑 앱을 위한 MCP 서버입니다.

MindNode Next(2024+ 세대)는 모든 문서를 개인용 SQLite/CRDT 라이브러리로 옮겼고, 자동화 표면이 전혀 없습니다: AppleScript 사전도, CLI도, 클라우드 API도, 심지어 디스크에 .mindnode 파일조차 없습니다. 이 프로젝트는 저장 형식을 리버스 엔지니어링하여 AI 에이전트가 마인드 맵을 읽고 만들 수 있게 해줍니다:

• 읽기 — 모든 마인드 맵을 Markdown 개요로: MindNode의 로컬 라이브러리에서 직접(SQLite → protobuf → Apple LZ4 → CRDT 디코드), 앱을 실행하지 않고도 읽습니다.

• 보기 — 렌더링된 맵을 그대로: MindNode 자체의 JPEG 미리보기로, 픽셀 단위까지 동일합니다.

• 생성 — Markdown 개요에서 새 마인드 맵 생성(앱 내에서 자동 가져오기).

• 열기 — mindnode:// URL 스킴으로 이름을 지정해 모든 맵을 엽니다.

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 라이브러리에 저장합니다. 각 문서는 protobuf 기본 스냅샷과 CRDT 작업 배치의 조합이며, 둘 다 작은 엔벨로프(필드 12345 = 버전, 필드 678910 = 페이로드 — 정말로 그렇습니다)에 감싸져 있고 Apple의 LZ4 프레이밍(bv41/bv4-/bv4$ 블록)으로 압축되어 있습니다.

이 저장소는 스키마 없는 protobuf 파서, 순수 TypeScript Apple-LZ4 디코더, 그리고 노드 생성 및 텍스트 작업을 재생하는 트리 재구성기를 제공합니다. 전체 리버스 엔지니어링 노트는 docs/FORMAT.md에 있습니다 — 직접 MindNode 도구를 만들고 싶다면 여기서 시작하세요. tools/spelunk.py는 라이브러리 blob을 자세히 들여다보기 위한 pretty-print 도구입니다.

쓰기 작업은 의도적으로 데이터베이스를 건드리지 않습니다(CloudKit 동기화가 있으므로, 손상시키면 안 됩니다). 새 문서는 MindNode 자체의 Markdown 가져오기 기능을 통해 open -a MindNode로 생성되며, 조용하고 무손실입니다.

주의사항

• get_mindmap은 CRDT 작업 스트림에서 텍스트를 재구성하는데, 위치 인코딩이 완전히 매핑되지 않았습니다: 많이 편집된 문자열은 약간 뒤섞여 나올 수 있고, 삭제된 노드는 (제목 없음)으로 남을 수 있습니다. 정확한 내용이 필요하면 get_mindmap_image를 사용하세요. create_mindmap으로 만든 문서는 무손실로 다시 읽힙니다.

• create_mindmap은 MindNode를 실행합니다(가져오기는 앱 내에서 조용히 진행됩니다).

• 라이브러리는 항상 읽기 전용입니다. 형식은 MindNode 2026.4.4에서 검증되었습니다. 향후 MindNode 업데이트에서 필드 번호가 바뀔 수 있습니다 — 개요가 비어서 돌아오면 tools/spelunk.py 출력과 함께 이슈를 올려주세요.

로드맵

• 노드 수준 편집(단일 노드 추가/이름 변경/삭제) 및 무손실 내보내기 — MindNode의 20가지 App Intent(CreateNode, EditNode, ExportDocument 등)를 Shortcuts으로 감싸서 제공

• 정확한 읽기를 위한 CRDT 텍스트 위치 인코딩 및 삭제 매핑

• 폴더 제목, 태그/스티커, 메모 필드

라이선스

MIT