MindMeister MCP 서버

Claude를 MindMeister API v2에 연결하여 Claude Desktop 또는 Claude Code에서 직접 AI 기반 마인드 맵 관리를 가능하게 하는 MCP (Model Context Protocol) 서버입니다.

MCP란 무엇인가요?

MCP는 Claude와 같은 AI 어시스턴트가 외부 도구 및 서비스와 상호 작용할 수 있도록 하는 개방형 표준입니다. 이 서버는 MindMeister 작업을 Claude가 대화 중에 호출할 수 있는 MCP 도구로 노출합니다.

사용 가능한 도구

도구	설명
`mindmeister_get_user`	인증된 사용자의 프로필 가져오기
`mindmeister_get_map`	특정 맵의 메타데이터 가져오기 (JSON)
`mindmeister_list_maps`	페이지네이션을 사용하여 맵 목록 가져오기
`mindmeister_export_map`	맵을 PDF, DOCX, PPTX, RTF 또는 이미지로 내보내기
`mindmeister_get_map_image`	맵의 이미지/썸네일 가져오기
`mindmeister_list_rights`	맵에 대한 공유 권한 목록 가져오기
`mindmeister_get_preferences`	사용자 기본 설정 가져오기

사전 요구 사항

Python 3.10 이상
API 액세스 권한이 있는 MindMeister 계정
MindMeister에서 발급받은 개인 액세스 토큰(Personal Access Token)

API 토큰 발급 방법

MindMeister에 로그인합니다.
계정(Account) → API → **개인 액세스 토큰(Personal Access Tokens)**으로 이동합니다.
필요한 범위(scope)를 선택하여 새 토큰을 생성합니다:
- mindmeister.readonly — 읽기 전용 액세스
- mindmeister — 전체 액세스
토큰을 복사합니다.

설치

옵션 1: 소스에서 설치

git clone https://github.com/conexaoarteiro/mindmeister-mcp.git
cd mindmeister-mcp
pip install -e .

옵션 2: GitHub에서 직접 설치

pip install git+https://github.com/conexaoarteiro/mindmeister-mcp.git

옵션 3: 수동 설정

git clone https://github.com/conexaoarteiro/mindmeister-mcp.git
cd mindmeister-mcp
pip install -r requirements.txt

구성

MindMeister API 토큰을 환경 변수로 설정합니다:

export MINDMEISTER_API_TOKEN="your_personal_access_token_here"

또는 .env.example을 기반으로 .env 파일을 생성합니다:

cp .env.example .env
# Edit .env and add your token

Claude Desktop에서 사용하기

claude_desktop_config.json에 다음을 추가합니다:

{
  "mcpServers": {
    "mindmeister": {
      "command": "python",
      "args": ["-m", "mindmeister_mcp.server"],
      "env": {
        "MINDMEISTER_API_TOKEN": "your_personal_access_token_here"
      }
    }
  }
}

pip install -e .로 설치한 경우 다음을 사용할 수도 있습니다:

{
  "mcpServers": {
    "mindmeister": {
      "command": "mindmeister-mcp",
      "env": {
        "MINDMEISTER_API_TOKEN": "your_personal_access_token_here"
      }
    }
  }
}

구성 파일 위치

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Code에서 사용하기

claude mcp add mindmeister -- python -m mindmeister_mcp.server

그런 다음 Claude Code를 실행하기 전에 환경 변수를 설정합니다:

export MINDMEISTER_API_TOKEN="your_token"
claude

대화 예시

구성이 완료되면 Claude에게 다음과 같이 요청할 수 있습니다:

"내 MindMeister 맵 보여줘"
"맵 1234567890의 세부 정보 가져와"
"맵 1234567890을 PDF로 내보내"
"맵 1234567890에 누가 액세스할 수 있어?"
"내 MindMeister 계정 정보가 뭐야?"

개발

# Clone and install in dev mode
git clone https://github.com/conexaoarteiro/mindmeister-mcp.git
cd mindmeister-mcp
pip install -e ".[dev]"

# Run the server directly
python -m mindmeister_mcp.server

프로젝트 구조

mindmeister-mcp/
├── README.md
├── pyproject.toml
├── requirements.txt
├── .env.example
├── .gitignore
└── src/
    └── mindmeister_mcp/
        ├── __init__.py
        ├── server.py      # FastMCP server with all tools
        ├── client.py       # Async HTTP client for MindMeister API v2
        └── models.py       # Pydantic input validation models

API 지원 범위

이 서버는 MindMeister API v2(https://www.mindmeister.com/api/v2/)를 대상으로 합니다. 다음 엔드포인트가 지원됩니다:

GET /users/me — 사용자 프로필
GET /maps/{id} — 맵 메타데이터
GET /maps — 맵 목록
GET /maps/{id} (Accept 헤더 포함) — PDF/DOCX/PPTX/RTF/이미지로 내보내기
GET /map_images/{id} — 맵 이미지
GET /maps/{id}/rights — 맵 권한
GET /users/me/preferences — 사용자 기본 설정

라이선스

MIT

Install Server

A

license - permissive license

A

quality

C

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

MindMeister MCP Server