MindManager MCP 서버

Windows 및 macOS에서 MindManager와 상호 작용하기 위한 표준화된 인터페이스를 제공하는 mindm 라이브러리를 위한 MCP(Model Context Protocol) 서버 구현입니다.

개요

이 서버를 사용하면 LLM에 컨텍스트와 도구를 제공하는 표준화된 방식인 모델 컨텍스트 프로토콜(MCP)을 통해 MindManager와 프로그래밍 방식으로 상호 작용할 수 있습니다. mindm 라이브러리를 활용하여 MindManager 문서, 주제, 관계 및 기타 마인드맵 요소를 조작합니다.

예:

특징

마인드맵 구조와 중심 주제를 검색합니다.
LLM 채팅에서 사용할 마인드맵을 Mermaid, Markdown, JSON 형식으로 내보냅니다.
MindManager 설치 및 라이브러리 폴더에 대한 정보를 얻으세요
MindManager에서 현재 선택 항목을 가져옵니다.

계획된 기능

직렬화된 데이터에서 새로운 마인드맵 만들기
주제 및 하위 주제 추가, 수정 및 조작
주제 간 관계 추가
주제에 태그 추가
문서 배경 이미지 설정

요구 사항

Python 3.12 이상
mcp 패키지(모델 컨텍스트 프로토콜 SDK)
mindm 라이브러리(이 프로젝트에 포함됨)
Windows 또는 macOS에 설치된 MindManager(지원 버전: 23-)

macOS 설치

지엑스피1

윈도우 설치

# 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

용법

MCP 검사관

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

클로드 데스크탑

로컬 파이썬 파일

필요에 따라 로컬 파일의 경로를 조정합니다.

{
  "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"
      ]
    }
  }
}

패키지 저장소의 모듈

필요에 따라 VIRTUAL_ENV 조정하세요.

{
    "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"
        }
      }
    }
}

힌트: Windows에서 MCP 서버가 망치 아이콘과 함께 표시되지 않으면 Claude Desktop을 닫고 모든 백그라운드 프로세스를 종료하세요.

MCP 도구

서버는 모델 컨텍스트 프로토콜을 통해 다음 도구를 제공합니다.

문서 상호 작용

get_mindmap : MindManager에서 현재 마인드맵 구조를 검색합니다.
get_selection : MindManager에서 현재 선택된 주제를 검색합니다.
get_library_folder : MindManager 라이브러리 폴더의 경로를 가져옵니다.
get_grounding_information : 마인드맵에서 접지 정보(중심 주제, 선택된 하위 주제)를 추출합니다.

직렬화

serialize_current_mindmap_to_mermaid : 현재 로드된 마인드맵을 Mermaid 형식으로 직렬화합니다.
serialize_current_mindmap_to_markdown : 현재 로드된 마인드맵을 마크다운 형식으로 직렬화합니다.
serialize_current_mindmap_to_json : 현재 로드된 마인드맵을 ID 매핑을 사용하여 자세한 JSON 객체로 직렬화합니다.

플랫폼 지원

Windows : 주제, 메모, 아이콘, 이미지, 태그, 링크, 관계 및 RTF 형식에 대한 전체 지원
macOS : 주제, 메모 및 관계 지원(Windows에 비해 지원이 제한됨)

Claude 및 기타 LLM과의 통합

이 MCP 서버는 Claude Desktop이나 다른 MCP 호환 애플리케이션에 설치하여 LLM이 다음을 수행할 수 있도록 합니다.

마인드맵 콘텐츠에 접근하세요
마인드맵 조작(향후 출시 예정)
LLM에서 생성된 콘텐츠를 기반으로 새로운 마인드맵을 만듭니다(출시 예정)

문제 해결

서버를 시작하기 전에 MindManager가 실행 중인지 확인하세요.
macOS의 경우 Claude Desktop이 MindManager를 자동화하도록 허용해야 합니다.

감사의 말

이 프로젝트는 mindm 라이브러리를 기반으로 구축되어 Windows 및 macOS 플랫폼에서 MindManager에 Python 인터페이스를 제공합니다. Anthropic에서 개발한 MCP(Model Context Protocol) SDK를 사용합니다.

특허

MIT 라이선스 - 자세한 내용은 라이선스 파일을 참조하세요.

MindManager MCP Server

Integrations