Mindpilot MCP
About
Visualize legacy code and inspect complex flows to understand your agent's operations.
Details
- Author
- abrinsmead
- Categories
- Developer Tools, Knowledge Base
Jump to
Setup
Install Mindpilot MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/abrinsmead/mindpilot-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
See through your agent's eyes. Visualize legacy code, inspect complex flows, understand everything.
[!TIP] Mindpilot is now available as a lightweightagent 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
- 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.
claude mcp add mindpilot -- npx @mindpilot/mcp@latest
UnderSettings>Cursor Settings>MCP> ClickAdd new global MCP serverand configure mindpilot in themcpServersobject.
{ "mcpServers": { "mindpilot": { "command": "npx", "args": ["@mindpilot/mcp@latest"] } } }
Follow the instructions here for enabling MCPs in VS Code:https://code.visualstudio.com/docs/copilot/chat/mcp-servers
Go toSettings>Features>MCP, then clickEdit in settings json
Then add mindpilot to your MCP configuration:
{ "mcp": { "servers": { "mindpilot": { "type": "stdio", "command": "npx", "args": ["@mindpilot/mcp@latest"] } } } }
UnderSettings>Windsurf Settings>Manage Plugins, clickview raw configand configure mindpilot in themcpServersobject:
{ "mcpServers": { "mindpilot": { "command": "npx", "args": ["@mindpilot/mcp@latest"] } } }
In the AI Thread panel click on the three dots..., then clickAdd Custom Server...
In theCommand to run MCPserverfield enternpx @mindpilot/mcp@latestand clickAdd Server.
- Port: The server defaults to port 4000 but can be configured using the--portcommand line switch.
- Data Path: By default, diagrams are saved to~/.mindpilot/data/. You can specify a custom location using the--data-pathcommand line switch.
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.
Mindpilot MCP collects anonymous usage data to help us understand how the product is being used and improve the user experience.
If you prefer not to share anonymous usage data, you can disable analytics by adding the--disable-analyticsflag to your MCP configuration:
claude mcp add mindpilot -- npx @mindpilot/mcp@latest --disable-analytics
Other IDEs:Add"--disable-analytics"to the args array in your configuration:
{ "command": "npx", "args": ["@mindpilot/mcp@latest", "--disable-analytics"] }
After configuring the MCP in your coding agent you can make requests like "create a diagram about x" and it should use the MCP server to render Mermaid diagrams for you in a browser connected to the MCP server.
You can optionally update your agent's rules file to give specific instructions about when to use mindpilot-mcp.
- "Show me the state machine for WebSocket connection logic"
- "Create a C4 context diagram of this project's architecture."
- "Show me the OAuth flow as a sequence diagram"
Frontier LLMs are well trained to generate valid Mermaid syntax. The MCP is designed to accept Mermaid syntax and render diagrams in a web app running onhttp://localhost:4000(default port).
If you use port 4000 for another service you can configure the MCP to use a different port.
Claude Code example:claude mcp add mindpilot -- npx @mindpilot/mcp@latest --port 5555
To save diagrams to a custom location (e.g., for syncing with cloud storage):
Claude Code example:claude mcp add mindpilot -- npx @mindpilot/mcp@latest --data-path /path/to/custom/location
{ "command": "npx", "args": ["@mindpilot/mcp@latest", "--data-path", "/path/to/custom/location"] }
If you useasdfas a version manager and have trouble getting MCPs to work (not just mindpilot), you may need to set a "global" nodejs version from your home directory.
Configure the MCP in your coding agent (usingclaudein this example)
claude mcp add mindpilot -- npx tsx <path to...>/src/server/server.ts
Runclaudewith the--debugflag if you need to see MCP errors
Start the development client (Vite) to get hot module reloading while developing.
Open the development clientlocalhost:5173
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Understand, develop, and debug authorization policies in Oso Cloud.
A stateful LSP runtime for AI agents: warm language server sessions with 50+ tools for go-to-definition, find-references, diagnostics, rename, and more across 30+ languages.
AI-powered code quality analysis to detect best practice violations, security issues, and architectural problems in real-time.
AmazingMCP — MCP Server for .NET / C# Codebases
An MCP server that gives AI agents deep understanding of C# codebases via Roslyn — type search, dependency graphs, usage analysis, and architecture overviews, all from a live in-memory compilation.
An experimental MCP server that uses the ast-grep CLI for code structural search, linting, and rewriting.
Enforce consistent C++ style and best practices across your codebase. Analyze naming conventions, memory safety, and const correctness, and get actionable modernization suggestions up to C++23. Accelerate reviews with ready-made prompts and quick access to curated guidelines.
Provides AI assistants with a comprehensive, one-time analysis for complete codebase context and understanding.
MCP server that gives coding agents program-analysis primitives — data flow, call graphs, taint analysis — so they reason from ground truth instead of grep-and-guess. (same as the GitHub About — keeps your messaging consistent across the web).
Scans code files for definitions, respects .gitignore, and outputs in LLM-friendly formats like XML or Markdown.
An MCP service that equips your workspace with a complete set of AI-accessible development tools for reading, editing, executing, and managing code.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





