Overview
Mindmap MCP Server is a Model Context Protocol (MCP) server designed to convert Markdown content into visually appealing mindmaps.
To use the Mindmap MCP Server, install it via pip or uvx, and configure it with your MCP client by adding it to the configuration file. You can also run it using Docker for easier setup.
- Converts Markdown to interactive HTML mindmaps. - Supports offline-capable mindmaps. - Options to customize toolbar visibility. - Returns either HTML content or file path for saved mindmaps.
- Creating visual representations of project plans from Markdown notes.
- Generating interactive mindmaps for educational content.
- Saving mindmaps as HTML files for sharing or presentation.
Add to your AI client
Use these steps to connect Mindmap MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"mindmap-mcp-server-yuchenssr": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mindmap-mcp-server-yuchenssr"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"mindmap-mcp-server-yuchenssr": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mindmap-mcp-server-yuchenssr"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mindmap-mcp-server-yuchenssr": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mindmap-mcp-server-yuchenssr"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mindmap-mcp-server-yuchenssr": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mindmap-mcp-server-yuchenssr"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mindmap-mcp-server-yuchenssr": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mindmap-mcp-server-yuchenssr"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mindmap-mcp-server-yuchenssr": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mindmap-mcp-server-yuchenssr"
]
}
}
}FAQ
What is the installation process?
You can install it using `pip install mindmap-mcp-server` or `uvx mindmap-mcp-server`.
Can I use it with other MCP clients?
Yes, it works with any MCP-compatible client, not just Claude for Desktop.
How do I troubleshoot common issues?
Check your Docker setup, ensure paths are correct, and verify that the server is running.