mcp-registry/mindmap-mcp-server

    ==================
      
       /// MCP ///
      /// MIN ///
        
    ==================
        
    [server:online]
    [protocol:ready]

mindmap-mcp-server

by YuChenSSR

A Model Context Protocol (MCP) server that converts Markdown into interactive markmap mind-maps and returns either raw HTML or a file path.

163
14
Open Source
GitHub

01

markdown-to-mindmap-content

Convert Markdown into an interactive mind-map and return the full HTML content.

02

markdown-to-mindmap-file

Convert Markdown into an interactive mind-map, save it as an HTML file in the mounted directory, and return the file path.

Installation

1. Prerequisites
• Python ≥3.9
• Git
• (recommended) virtualenv / venv
2. Clone the repository
git clone https://github.com/YuChenSSR/mindmap-mcp-server.git cd mindmap-mcp-server
3. Create and activate a virtual environment
python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate
4. Install dependencies
pip install -r requirements.txt
5. Configure the server (examples)
• Copy the sample env file if present, or create .env in the project root.
• Adjust other settings in config.py as needed (database, logging, etc.).
MCP_HOST=0.0.0.0 MCP_PORT=8080 AUTH_TOKEN=<your-secret-token>
6. Run the server
python main.py # or the entry-point script specified in README
7. Verify it is working
curl http://localhost:8080/health # should return {"status":"ok"}
8. (Optional) Production deployment
• Use a WSGI container such as gunicorn:
• Place behind Nginx / Traefik for TLS termination.
gunicorn -w 4 -b 0.0.0.0:8080 mindmap_mcp_server.app:app
9. Upgrade
git pull && pip install -r requirements.txt --upgrade

Documentation

License: MIT License
Updated 7/30/2025