Markmap

You can run a Markmap MCP Server to turn Markdown into interactive mind maps, then store and access them via OSS and Minio with automatic exports. This server lets you generate mind maps from plain text, interact with them in the browser, and share links for download and online preview.

How to use

Start the MCP server locally and connect it to your MCP client. The server runs as a stdio process, so you initiate it via a command that launches the Markmap MCP Server and keeps it running in the background for your client to communicate with.

How to install

Prerequisites: you need Node.js (v20 or above). Install the Markmap MCP Server globally and run it from the command line.

# Install from npm globally
npm install @jiushan93/markmap-mcp-server -g

# Basic run
npx -y @jiushan93/markmap-mcp-server

# Specify output directory
npx -y @jiushan93/markmap-mcp-server --output /path/to/output/directory

Configuration and usage notes

You will run a local MCP configuration that uses a stdio server. The MCP config defines the server name, how to start it, and the environment variables required for access to cloud storage and AI services.

Below is the explicit configuration snippet you should place in your MCP settings. It starts the Markmap MCP Server using npx and passes through the required environment variables for API access and storage keys.

{
  "mcpServers": {
    "markmap": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@jiushan93/markmap-mcp-server"],
      "env": {
        "DASHSCOPE_API_KEY": "sk-your-dashscope-api-key",
        "OSS_ACCESS_KEY_ID": "your-oss-access-key-id",
        "OSS_ACCESS_KEY_SECRET": "your-oss-access-key-secret",
        "MINIO_ACCESS_KEY": "your-minio-access-key",
        "MINIO_SECRET_KEY": "your-minio-secret-key"
      }
    }
  }
}

Security and keys you need

This setup requires five environment variables to be configured: a DashScope or Qwen API key, and credentials for Aliyun OSS and Minio. Keep these keys secure and never commit them to source control.

Notes and tips

• Mind maps are uploaded to both OSS and Minio, providing download and preview links. The OSS link is suitable for long-term access, while Minio offers fast preview URLs.

• You can export generated mind maps to PNG, JPG, SVG, or FreeMind (.mm) formats and copy the original Markdown content with a single action.

• Temporary local files are automatically cleaned up after upload to OSS/Minio.

Troubleshooting

If you encounter issues with uploading to OSS or Minio, verify that the provided keys are correct and that the storage endpoints are reachable from your host. Check that your environment variables are correctly exported to the MCP process.

Available tools

text-to-mindmap

Converts plain text descriptions into interactive mind maps using AI and uploads them to OSS for long-term access.