MCP Mindmap Stable Wrapper

A stable wrapper for the Mindmap MCP Server that handles stdout pollution and ensures reliable operation with Claude Code.

🎯 Problem Solved

Many mindmap MCP servers output startup messages to stdout which breaks the MCP protocol. This wrapper:

• Filters stdout pollution
• Handles errors gracefully
• Ensures files are saved to the correct directory
• Works reliably with Claude Code CLI

📦 Installation

# Clone and install
git clone https://github.com/galacoder/mcp-mindmap-stable.git
cd mcp-mindmap-stable
pip install -e .

# Or install directly
pip install git+https://github.com/galacoder/mcp-mindmap-stable.git

🚀 Usage with Claude Code

# Using the wrapper script
claude mcp add mindmap "python3" "/path/to/wrapper.py" "--" "--output" "."

# Or if installed globally
claude mcp add mindmap "mindmap-mcp-stable" "--" "--output" "."

🛠️ How It Works

The wrapper:

1. Intercepts the mindmap server launch
2. Filters out startup messages
3. Ensures proper MCP protocol communication
4. Handles errors with proper JSON-RPC responses

📄 Supported Servers

Works with:

• @jinzcdev/markmap-mcp-server (recommended)
• Other mindmap servers with stdout issues

📄 License

MIT License