Integrates with Alibaba Cloud services including DashScope API for AI-powered mind map generation using Qwen models, and Object Storage Service (OSS) for automatically uploading and hosting generated mind maps with signed URLs
Converts Markdown text and files (including from URLs) into interactive mind maps with support for rich formatting and hierarchical structures
Markmap MCP Server
Markmap MCP Server is based on the Model Context Protocol (MCP) that allows one-click conversion of Markdown text to interactive mind maps, built on the open source project markmap. The generated mind maps support rich interactive operations and can be exported in various image formats.
🎉 Explore More Mind Mapping Tools
Try MarkXMind - An online editor that creates complex mind maps using simple XMindMark syntax. It supports real-time preview, multi-format export (.xmind/.svg/.png), importing existing XMind files. Try it now!
Features
🤖 AI-Powered Generation: Generate mind maps from plain text using Alibaba Cloud Qwen AI (NEW in v0.2.0)
🌠 Markdown to Mind Map: Convert Markdown text to interactive mind maps
🔗 URL Download Support: Download Markdown files directly from URLs for conversion
☁️ Aliyun OSS Integration: Automatically upload generated mind maps to Aliyun Object Storage and get online access links
🖼️ Multi-format Export: Support for exporting as PNG, JPG, and SVG images
🔄 Interactive Operations: Support for zooming, expanding/collapsing nodes, and other interactive features
📋 Markdown Copy: One-click copy of the original Markdown content
🧹 Auto Cleanup: Automatically delete local temporary files after OSS upload
Prerequisites
Node.js (v20 or above)
Installation
Manual Installation
Alternatively, you can clone the repository and run locally:
Usage
Configuration (AI and OSS Required)
⚠️ Important: This tool requires API keys from environment variables to work.
The following configurations are pre-configured in the code:
OSS Bucket:
aiagenttestOSS Region:
oss-cn-beijingOSS Endpoint:
oss-cn-beijing.aliyuncs.comQwen Model:
qwen3-235b-a22b-thinking-2507API URL:
https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
You only need to provide the API keys:
Environment Variables
Required API Keys (Must be configured):
DASHSCOPE_API_KEYorQWEN_API_KEY: Your Alibaba Cloud DashScope API key (Required)Get from: https://dashscope.console.aliyun.com/
OSS_ACCESS_KEY_ID: Aliyun OSS Access Key ID (Required)OSS_ACCESS_KEY_SECRET: Aliyun OSS Access Key Secret (Required)
Pre-configured Settings (Hard-coded in the application):
Model:
qwen3-235b-a22b-thinking-2507API URL:
https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completionsOSS Bucket:
aiagenttestOSS Region:
oss-cn-beijingOSS Endpoint:
oss-cn-beijing.aliyuncs.com
Optional Configuration:
MARKMAP_DIR: Specify the output directory for temporary files (defaults to system temp directory)
⚠️ Important Notes:
Only API keys need to be configured via environment variables
All other settings (bucket, region, model) are pre-configured
Mind maps are stored in OSS and return signed URLs (5-year validity)
Temporary local files are automatically deleted after OSS upload
Available Tool
text-to-mindmap
Convert plain text descriptions into interactive mind maps using AI.
The text will be processed by Qwen AI model to generate structured Markdown, then converted to a mind map and automatically uploaded to OSS.
Parameters:
text: Text description to convert into a mind map (required string)
Example:
Return Value:
On success, returns only the URL:
On failure, returns error details:
Requirements:
✅ Qwen API configuration (required)
✅ OSS configuration (required)
License
This project is licensed under the MIT License.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables conversion of plain text descriptions and Markdown content into interactive mind maps using AI. Automatically uploads generated mind maps to Aliyun OSS and provides online access links.