MindMeister MCP Server

Сервер MCP (Model Context Protocol), который подключает Claude к MindMeister API v2, обеспечивая управление интеллект-картами с помощью ИИ напрямую из Claude Desktop или Claude Code.

Что такое MCP?

MCP — это открытый стандарт, позволяющий ИИ-ассистентам, таким как Claude, взаимодействовать с внешними инструментами и сервисами. Этот сервер предоставляет операции MindMeister в качестве инструментов MCP, которые Claude может вызывать во время диалогов.

Доступные инструменты

Предварительные требования

• Python 3.10+

• Учетная запись MindMeister с доступом к API

• Токен личного доступа (Personal Access Token) от MindMeister

Получение API-токена

1. Войдите в MindMeister

2. Перейдите в Account → API → Personal Access Tokens

3. Создайте новый токен с необходимыми областями доступа (scopes):

   • mindmeister.readonly — для доступа только для чтения

   • mindmeister — для полного доступа

4. Скопируйте токен

Установка

Вариант 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

Конфигурация

Установите ваш API-токен MindMeister в качестве переменной окружения:

export MINDMEISTER_API_TOKEN="your_personal_access_token_here"

Или создайте файл .env на основе .env.example:

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 о следующем:

• "Show me my MindMeister maps"

• "Get the details of map 1234567890"

• "Export map 1234567890 as PDF"

• "Who has access to map 1234567890?"

• "What are my MindMeister account details?"

Разработка

# 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