Xmind Generator MCP Server
An MCP (Model Context Protocol) server for generating Xmind mind maps. This server allows LLMs to create structured mind maps through the MCP protocol.
Features
- Generate Xmind mind maps with hierarchical topic structures
- Support for topic notes, labels, and markers
- Save mind maps to local files
- Easy integration with Claude Desktop and other MCP clients
Prerequisites
- Node.js: Version 18 or higher is required
- Xmind: Install Xmind desktop application to open and edit the generated mind maps
- Claude Desktop: Required to use this tool as an extension
Setup with Claude Desktop
Option 1: Using npx (Recommended)
-
Create or edit the Claude Desktop configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
-
Add the following configuration:
{ "mcpServers": { "xmind-generator": { "command": "npx", "args": ["xmind-generator-mcp"], "env": { "outputPath": "/path/to/save/xmind/files", "autoOpenFile": "false" } } } } -
Restart Claude Desktop
-
Start using the Xmind generator in your conversations
Option 2: Local Installation
-
Clone the repository:
git clone https://github.com/BangyiZhang/xmind-generator-mcp.git cd xmind-generator-mcp npm install npm run build -
Create or edit the Claude Desktop configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
-
Add the following configuration:
{ "mcpServers": { "xmind-generator": { "command": "node", "args": ["path/to/xmind-generator-mcp/dist/index.js"], "env": { "outputPath": "/path/to/save/xmind/files", "autoOpenFile": "false" } } } } -
Replace
path/to/xmind-generator-mcpwith the actual path to your cloned project -
Restart Claude Desktop
-
Start using the Xmind generator in your conversations
Note: The env section is optional. It allows you to set environment variables for the server:
outputPath: Default directory or file path where Xmind files will be saved. This can be overridden by theoutputPathparameter in the tool call.autoOpenFile: Controls whether generated Xmind files are automatically opened after creation. Set to "false" to disable auto-opening (default is "true").
Available Tools
generate-mind-map
Generates an Xmind mind map from a hierarchical structure of topics.
Parameters:
title(string): The title of the mind map (root topic)topics(array): Array of topics to include in the mind maptitle(string): The title of the topicref(string, optional): Reference ID for the topicnote(string, optional): Note for the topiclabels(array of strings, optional): Labels for the topicmarkers(array of strings, optional): Markers for the topic (format: "Category.name", e.g., "Arrow.refresh")children(array, optional): Array of child topics
relationships(array, optional): Array of relationships between topicsoutputPath(string, optional): Custom output path for the Xmind file. This overrides the environment variable if set.
Example
Here's an example of how to use the generate-mind-map tool:
{
"title": "Project Plan",
"topics": [
{
"title": "Research",
"ref": "topic:research",
"note": "Gather information about the market",
"children": [
{
"title": "Market Analysis",
"labels": ["Priority: High"]
},
{
"title": "Competitor Research",
"markers": ["Task.quarter"]
}
]
},
{
"title": "Development",
"children": [
{
"title": "Frontend",
"markers": ["Arrow.refresh"]
},
{
"title": "Backend"
}
]
}
]
}
License
MIT