Mindmap MCP Server

Ein Model Context Protocol (MCP)-Server zum Konvertieren von Markdown-Inhalten in interaktive Mindmaps.

Installation

pip install mindmap-mcp-server

Oder mit uvx :

uvx mindmap-mcp-server

Oder die Verwendung docker ist sicherer und einfacher.

Related MCP server: MarkItDown MCP Server

Aufmerksamkeit

Drei Installationsmethoden wurden erfolgreich unter macOS und Linux getestet.

Windows-Benutzer, die Probleme mit npx für dieses MCP haben, sollten die Docker-Methode verwenden. Alternativ bietet die Erweiterung „Markmap“ bei Verwendung von Visual Studio Code eine möglicherweise einfachere Lösung als die Verwendung von Befehlszeilentools.

Wenn bei Ihnen ungelöste Probleme auftreten, können Sie meine aktuelle Systemaufforderung als Mindmap-Assistent verwenden, anstatt diesen MCP-Server zu verwenden.

You are a specialized assistant that generates HTML code for interactive markdown-based mind maps (markmaps). When a user sends you content, respond with a complete HTML document that displays their content as a markmap visualization.
If artifact tool is turned on, you can use the artifact.

Follow these requirements:
1. Use the markmap-autoloader library (version 0.18 or latest stable version)
2. Format the HTML exactly according to the template below
3. Replace the demo content in the template with the user's content, preserving their hierarchical structure
4. Maintain the markmap configuration options (maxWidth: 300, colorFreezeLevel: 2)
5. If the user doesn't provide markdown formatting (# for headings), format their content appropriately with main topics using # and subtopics using ##

Template to follow:

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Markmap</title>
    <style>
      svg.markmap {
        width: 100%;
        height: 100vh;
      }
    </style>
    <script src="https://cdn.jsdelivr.net/npm/markmap-autoloader@0.18"></script>
  </head>
  <body>
    <div class="markmap">
      <script type="text/template">
        ---
        markmap:
          maxWidth: 300
          colorFreezeLevel: 2
        ---

        # markmap

        ## Links

        - <https://markmap.js.org/>
        - [GitHub](https://github.com/markmap/markmap)

        ## Related

        - [coc-markmap](https://github.com/markmap/coc-markmap)
        - [gatsby-remark-markmap](https://github.com/markmap/gatsby-remark-markmap)

        ## Features

        - links
        - **inline** ~~text~~ *styles*
        - multiline
          text
        - `inline code`
        - Katex - $x = {-b \pm \sqrt{b^2-4ac} \over 2a}$
        - This is a very very very very very very very very very very very very very very very long line.
      </script>
    </div>
  </body>
</html>

Visualisierungsoptionen: (Wenn Formeln oder Symbole nicht richtig angezeigt werden, laden Sie die HTML-Datei herunter und öffnen Sie sie in einem Browser.)

1. Zeigen Sie die Mindmap in Artefakten an (falls verfügbar):

2. Rendern Sie die HTML-Datei als Mindmap:

Voraussetzungen

Dieses Paket erfordert die Installation von Node.js, wenn Sie zum Ausführen des Servers den Befehl python oder uvx verwenden.

Verwendung

Mit Claude Desktop oder anderen MCP-Clients

Fügen Sie diesen Server zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "mindmap": {
      "command": "uvx",
      "args": ["mindmap-mcp-server", "--return-type", "html"]
    }
  }
}

oder

empfohlen:

{
  "mcpServers": {
    "mindmap": {
      "command": "uvx",
      "args": ["mindmap-mcp-server", "--return-type", "filePath"]
    }
  }
}

Wir verwenden --return-type , um den Rückgabetyp des Mindmap-Inhalts anzugeben. Sie können je nach Bedarf html oder filePath auswählen.
html gibt den gesamten HTML-Inhalt der Mindmap zurück, den Sie im Artefakt Ihres KI-Clients in der Vorschau anzeigen können.

filePath speichert die Mindmap in einer Datei und gibt den Dateipfad zurück, den Sie in Ihrem Browser öffnen können. So können Sie Ihre Token speichern !

Verwenden einer bestimmten Python-Datei in diesem Repository:

{
  "mcpServers": {
    "mindmap": {
      "command": "python",
      "args": ["/path/to/your/mindmap_mcp_server/server.py", "--return-type", "html"]
    }
  }
}

oder

{
  "mcpServers": {
    "mindmap": {
      "command": "python",
      "args": ["/path/to/your/mindmap_mcp_server/server.py", "--return-type", "filePath"]
    }
  }
}

Wir verwenden --return-type , um den Rückgabetyp des Mindmap-Inhalts anzugeben. Sie können je nach Bedarf html oder filePath wählen. Weitere Einzelheiten finden Sie unter „Verwendung von „uvx“.

Zuerst ziehen Sie das Bild:

docker pull ychen94/mindmap-converter-mcp

Zweitens, richten Sie den Server ein:

{
  "mcpServers": {
    "mindmap-converter": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-v", "/path/to/output/folder:/output", "ychen94/mindmap-converter-mcp:latest"]
    }
  }
}

⚠️ Ersetzen Sie /path/to/output/folder durch einen tatsächlichen Pfad auf Ihrem System, in dem Sie Mindmaps speichern möchten, z. B. /Users/username/Downloads unter macOS oder C:\\Users\\username\\Downloads unter Windows.

Im Docker-Container bereitgestellte Tools Der Server stellt die folgenden MCP-Tools bereit:

1. Markdown-zu-Mindmap-Inhalt
   Konvertiert Markdown in eine HTML-Mindmap und gibt den gesamten HTML-Inhalt zurück.
   Sie verwenden die Argumente -v und /path/to/output/folder:/output nicht im Befehl „ docker .
   Parameter :
   • markdown (Zeichenfolge, erforderlich): Der zu konvertierende Markdown-Inhalt
   • Symbolleiste (Boolesch, optional): Ob die Symbolleiste angezeigt werden soll (Standard: true)
   Am besten geeignet für : Einfache Mindmaps, bei denen die Größe des HTML-Inhalts keine Rolle spielt. Sie können Artefakte in Ihrem KI-Client verwenden, um eine Vorschau der Mindmap anzuzeigen.

2. Markdown-zu-Mindmap-Datei
   Konvertiert Markdown in eine HTML-Mindmap und speichert sie in einer Datei im bereitgestellten Verzeichnis.
   Parameter :
   • markdown (Zeichenfolge, erforderlich): Der zu konvertierende Markdown-Inhalt
   • Dateiname (Zeichenfolge, optional): Benutzerdefinierter Dateiname (Standard: automatisch generierter Zeitstempelname)
   • Symbolleiste (Boolesch, optional): Ob die Symbolleiste angezeigt werden soll (Standard: true)
   Am besten geeignet für : Komplexe Mindmaps oder wenn Sie die Token zur späteren Verwendung speichern möchten.
   Sie können die HTML-Datei in Ihrem Browser öffnen, um die Mindmap anzuzeigen. Alternativ können Sie den iterm-mcp-Server oder die MCP-Server anderer Terminals verwenden, um die Datei in Ihrem Browser zu öffnen, ohne Ihren Arbeitsablauf zu unterbrechen.

Fehlerbehebung

Datei nicht gefunden
Wenn auf Ihre Mindmap-Datei nicht zugegriffen werden kann:
1 Überprüfen Sie, ob Sie ein Volume korrekt im Docker-Container gemountet haben
2 Stellen Sie sicher, dass das Pfadformat für Ihr Betriebssystem korrekt ist
3 Stellen Sie sicher, dass Docker die Berechtigung hat, auf das Verzeichnis zuzugreifen

Docker-Befehl nicht gefunden
1 Überprüfen Sie, ob Docker installiert ist und sich in Ihrem PATH befindet
2 Versuchen Sie, den absoluten Pfad zu Docker zu verwenden

Server wird in Claude nicht angezeigt
1 Starten Sie Claude für Desktop nach Konfigurationsänderungen neu
2 Überprüfen Sie die Claude-Protokolle auf Verbindungsfehler
3 Überprüfen Sie, ob Docker ausgeführt wird

Erweiterte Nutzung
Verwendung mit anderen MCP-Clients
Dieser Server funktioniert mit jedem MCP-kompatiblen Client, nicht nur mit Claude für Desktop. Der Server implementiert die Spezifikation des Model Context Protocol (MCP) Version 1.0.

Merkmale

Dieser Server bietet ein Tool zum Konvertieren von Markdown-Inhalten in Mindmaps mithilfe der Bibliothek markmap-cli :

• Konvertieren Sie Markdown in interaktives Mindmap-HTML

• Möglichkeit zur Erstellung offlinefähiger Mindmaps

• Option zum Ausblenden der Symbolleiste

• Gibt entweder HTML-Inhalt oder Dateipfad zurück

Beispiel

In Claude können Sie fragen:

" Erstellen Sie mithilfe eines Mindmap-Tools eine Mindmap für den folgenden Markdown-Code:

# Project Planning
## Research
### Market Analysis
### Competitor Review
## Design
### Wireframes
### Mockups
## Development
### Frontend
### Backend
## Testing
### Unit Tests
### User Testing

"

Wenn Sie die Mindmap in einer Datei speichern und sie dann mithilfe des iTerm MCP-Servers in Ihrem Browser öffnen möchten:

" Erstellen Sie mithilfe eines Mindmap-Tools eine Mindmap für den folgenden Markdown-Eingabecode. Öffnen Sie anschließend die generierte HTML-Datei mit iterm. Eingabecode:

markdown content

"

„ Denken Sie an den Vorgang, einen Elefanten in einen Kühlschrank zu legen, und erstellen Sie eine Mindmap. Öffnen Sie diese mit einem Terminal. “

und mehr

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Weitere Informationen finden Sie in der LICENSE-Datei in diesem Projekt-Repository.

Wenn dieses Projekt für Sie hilfreich ist, geben Sie ihm bitte einen Stern ⭐️

Der technologische Fortschritt sollte allen Menschen zugute kommen und nicht die breite Masse ausbeuten.