Installation

Installing via Smithery

To install Markmap MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @jinzcdev/markmap-mcp-server --client claude

Manual Installation

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

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

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

Alternatively, you can clone the repository and run locally:

# Clone the repository
git clone https://github.com/jinzcdev/markmap-mcp-server.git

# Navigate to the project directory
cd markmap-mcp-server

# Build project
npm install && npm run build

# Run the server
node build/index.js

Usage

Add the following configuration to your MCP client configuration file:

{
  "mcpServers": {
    "markmap": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@jinzcdev/markmap-mcp-server"],
      "env": {
        "MARKMAP_DIR": "/path/to/output/directory"
      }
    }
  }
}

[!TIP]

The service supports the following environment variables:

• MARKMAP_DIR: Specify the output directory for mind maps (optional, defaults to system temp directory)

Priority Note:

When both the --output command line argument and the MARKMAP_DIR environment variable are specified, the command line argument takes precedence.

Available Tools

markdown-to-mindmap

Convert Markdown text into an interactive mind map.

Parameters:

• markdown: The Markdown content to convert (required string)
• open: Whether to automatically open the generated mind map in the browser (optional boolean, default is false)

Return Value:

{
  "content": [
    {
      "type": "text",
      "text": "JSON_DATA_OF_MINDMAP_FILEPATH"
    }
  ]
}

Related Projects

🎉 Explore More Mind Mapping Tools:

| Project | Description | | ------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | MarkXMind Online | Create XMind mind maps with Markdown online. Supports real-time preview, one-click export as .xmind / .md / .png / .svg, and importing existing XMind files. Try it now → | | Obsidian MarkXMind Plugin | An Obsidian plugin that supports rendering XMindMark syntax as XMind mind maps inside xmind code blocks. |

License

This project is licensed under the MIT License.