MindMeister MCP-Server

Ein MCP (Model Context Protocol)-Server, der Claude mit der MindMeister API v2 verbindet und eine KI-gestützte Mindmap-Verwaltung direkt aus Claude Desktop oder Claude Code ermöglicht.

Was ist MCP?

MCP ist ein offener Standard, der es KI-Assistenten wie Claude ermöglicht, mit externen Tools und Diensten zu interagieren. Dieser Server stellt MindMeister-Operationen als MCP-Tools bereit, die Claude während Unterhaltungen aufrufen kann.

Verfügbare Tools

Voraussetzungen

• Python 3.10+

• Ein MindMeister-Konto mit API-Zugriff

• Ein Personal Access Token von MindMeister

API-Token abrufen

1. Melden Sie sich bei MindMeister an

2. Gehen Sie zu Konto → API → Personal Access Tokens

3. Erstellen Sie ein neues Token mit den benötigten Scopes:

   • mindmeister.readonly — für schreibgeschützten Zugriff

   • mindmeister — für vollen Zugriff

4. Kopieren Sie das Token

Installation

Option 1: Installation aus dem Quellcode

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

Option 2: Installation direkt von GitHub

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

Option 3: Manuelle Einrichtung

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

Konfiguration

Setzen Sie Ihr MindMeister API-Token als Umgebungsvariable:

export MINDMEISTER_API_TOKEN="your_personal_access_token_here"

Oder erstellen Sie eine .env-Datei basierend auf .env.example:

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

Verwendung mit Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

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

Wenn Sie mit pip install -e . installiert haben, können Sie auch Folgendes verwenden:

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

Speicherort der Konfigurationsdatei

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Verwendung mit Claude Code

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

Setzen Sie dann die Umgebungsvariable, bevor Sie Claude Code ausführen:

export MINDMEISTER_API_TOKEN="your_token"
claude

Beispiel-Unterhaltungen

Sobald die Konfiguration abgeschlossen ist, können Sie Claude Dinge fragen wie:

• "Zeige mir meine MindMeister-Maps"

• "Rufe die Details der Map 1234567890 ab"

• "Exportiere Map 1234567890 als PDF"

• "Wer hat Zugriff auf Map 1234567890?"

• "Was sind meine MindMeister-Kontodetails?"

Entwicklung

# 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

Projektstruktur

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-Abdeckung

Dieser Server zielt auf die MindMeister API v2 (https://www.mindmeister.com/api/v2/) ab. Die folgenden Endpunkte werden abgedeckt:

• GET /users/me — Benutzerprofil

• GET /maps/{id} — Map-Metadaten

• GET /maps — Maps auflisten

• GET /maps/{id} (mit Accept-Header) — Export als PDF/DOCX/PPTX/RTF/Bild

• GET /map_images/{id} — Map-Bild

• GET /maps/{id}/rights — Map-Berechtigungen

• GET /users/me/preferences — Benutzereinstellungen

Lizenz

MIT