mindmap-mcp-server
Author: YuChenSSR
Description: A Model Context Protocol (MCP) server that converts Markdown into interactive markmap mind-maps and returns either raw HTML or a file path.
Stars: 163
Forks: 14
License: MIT License
Category: Open Source
Overview
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-server3. Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate4. Install dependencies
pip install -r requirements.txt5. 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 README7. 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:app9. Upgrade
git pull && pip install -r requirements.txt --upgrade01
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.
License: MIT License
Updated 7/30/2025