BangyiZhang/xmind-generator-mcp
If you are the rightful owner of xmind-generator-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
An MCP server for generating Xmind mind maps, allowing LLMs to create structured mind maps through the MCP protocol.
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
