abrinsmead/mindpilot-mcp

See through your agent's eyes. Visualize legacy code, inspect complex flows, understand everything.
> [!TIP]
> Mindpilot is now available as a lightweight agent skill—no local MCP server needed. Ask your agent to diagram something and it builds a self-contained, interactive Mermaid viewer you can open in your browser or publish as a Claude artifact.
>
> Install with: npx skills add abrinsmead/skills/mermaid-viewer
Why Mindpilot?
- **Visualize Anything**: Use your coding agent to generate on-demand architecture, code, and process diagrams to view your code from different perspectives.
- **Vibe Checks**: AI-generated code can accumulate unused and redundant constructs. Use visualizations to spot areas that need cleanup.
- **Local Processing**: Diagrams are never sent to the cloud. Everything stays between you, your agent, and your agent's LLM provider(s).
- **Export & Share**: Export any diagram as a vector image.
Prerequisites
Node.js v20.0.0 or higher.
Quickstart
Claude Code
claude mcp add mindpilot -- npx @mindpilot/mcp@latest
Cursor
Under Settings > Cursor Settings > MCP > Click Add new global MCP server and configure mindpilot in the mcpServers object.
VS Code
Follow the instructions here for enabling MCPs in VS Code: https://code.visualstudio.com/docs/copilot/chat/mcp-servers
Go to Settings > Features > MCP, then click Edit in settings json
Then add mindpilot to your MCP configuration:
Windsurf
Under Settings > Windsurf Settings > Manage Plugins, click view raw config and configure mindpilot in the mcpServers object:
Zed
In the AI Thread panel click on the three dots ..., then click Add Custom Server...
In the Command to run MCPserver field enter npx @mindpilot/mcp@latest and click Add Server.
Configuration Options
- **Port**: The server defaults to port 4000 but can be configured using the --port command line switch.
- **Data Path**: By default, diagrams are saved to ~/.mindpilot/data/. You can specify a custom location using the --data-path command line switch.
Multi-Client Support
Mindpilot intelligently handles multiple AI assistants running simultaneously. When you have multiple Claude Desktop windows or IDE instances open:
- The first mcp client to use Mindpilot starts a shared web server
- Additional assistants automatically connect to the existing server
- All assistants share the same diagram history and web interface
- The server will automatically shuts down a minute after the last MCP clinet disconnects
This means you can work with multiple MCP hosts at once without port conflicts, and they'll all contribute to the same collection of diagrams.
Anonymous Usage Tracking
Mindpilot MCP collects anonymous usage data to help us understand how the product is being used and improve the user experience.
Disabling Analytics
If you prefer not to share anonymous usage data, you can disable analytics by adding the --disable-analytics flag to your MCP configuration:
**Claude Code:**
**Other IDEs:**
Add "--disable-analytics" to the args array in your configuration: