M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
M

Mindpilot MCP

Community
See through your agent's eyes. Visualize legacy code, architect new systems, understand everything.
How to install ↓ Compare GitHub source repository ↗
Category
Dev Tools #280 of 438
Stars
★ 90 Popular
Transport
stdio (local process)
Runtime
Node.js 20.0.0+
Credentials
No credential needed
License
MIT
Last commit
48FMRS · D

Mindpilot MCP provides useful visualization for AI coding assistants, enabling local Mermaid diagram generation. It works well with multi-client sharing and export features, but anonymous usage tracking and local server may require caution.

Strongest · Documentation 12/20 Weakest · Reliability 8/20

Reliability
8/20
Security and permissions
8/20
Maintenance
10/20
Documentation
12/20
Setup experience
10/20
Why each score
Reliability 8/20
Evidence shows the README's claimed functionality (rendering Mermaid diagrams) aligns with the basic design, and Node.js requirements are specified. However, source code is unavailable, so key paths (MCP initialization, tool-list handshake, error handling) cannot be verified. No tests or CI workflows are present. Thus, score is 8.
Security and permissions 8/20
Source code is not available, so credential handling, data boundaries, and external network behavior cannot be inspected. README mentions anonymous usage tracking but lacks details. No obvious malicious or dangerous operations detected. Based on limited evidence, score is 8, but with uncertainty.
Maintenance 10/20
Repository has MIT license, is active (90 stars, 11 open issues, not archived). README indicates versioning and releases. However, no security response channel or detailed maintenance history. Score is 10.
Documentation 12/20
README provides detailed installation, configuration, and troubleshooting instructions, including examples for multiple clients. Missing tool parameters, limitations, and cost details, and no verifiable evidence. Score is 12.
Setup experience 10/20
README offers clear installation steps and configuration examples for mainstream clients. However, no source code or verification evidence. Score is 10.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the network

Best for

  • Developers who want to visualize complex codebases
  • Teams using AI coding assistants and wanting to review generated code
  • Developers needing quick architecture and process diagrams
  • Users concerned about local data processing and privacy

Not for

  • Users who don't need visual diagrams or charting capabilities
  • Teams with strict budgets that want to completely disable anonymous usage tracking
  • Users needing cloud-based diagram sharing or collaboration
  • Users unfamiliar with Mermaid diagram syntax (requires LLM to generate it)

Required permissions

  • Local file system access: saves diagrams in `~/.mindpilot/data/` or custom data path
  • Network: starts a local web server (default port 4000) to display diagrams
  • Anonymous usage data collection: enabled by default, can be disabled with `--disable-analytics` flag

Risks and side effects

  • Anonymous usage data collection by default: may not meet strict privacy requirements, but can be disabled with flag
  • Local server listening on port 4000: may conflict with existing services
  • Relies on LLM to generate valid Mermaid syntax: incorrect generation may fail to render
  • Multi-client support means multiple sessions share the same server; data might be unintentionally exposed to other local clients

Setup

Before you start

Runtime：Node.js 20.0.0+

### Claude Code
Run claude mcp add mindpilot -- npx @mindpilot/mcp@latest

### Cursor
Under Settings > Cursor Settings > MCP, add a global MCP server with the following configuration:

{
  "mcpServers": {
    "mindpilot": {
      "command": "npx",
      "args": ["@mindpilot/mcp@latest"]
    }
  }
}

### VS Code
Follow the [VS Code MCP guide](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) to enable MCP, then add to settings json:

{
  "mcp": {
    "servers": {
      "mindpilot": {
        "type": "stdio",
        "command": "npx",
        "args": ["@mindpilot/mcp@latest"]
      }
    }
  }
}

### Windsurf
Under Settings > Windsurf Settings > Manage Plugins, view raw config and configure in the mcpServers object.

### Zed
In the AI Thread panel, click the three dots ..., then select Add Custom Server..., enter npx @mindpilot/mcp@latest in the command field.

claude_desktop_config.json 
{
  "mcpServers": {
    "mindpilot": {
      "command": "npx",
      "args": [
        "@mindpilot/mcp@latest"
      ]
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json
{
  "servers": {
    "mindpilot": {
      "command": "npx",
      "args": [
        "@mindpilot/mcp@latest"
      ]
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add mindpilot -- npx @mindpilot/mcp@latest

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

After configuring, restart your client and ask the agent to create a diagram (e.g. "create a diagram about x"); a rendered Mermaid diagram should appear in a browser at http://localhost:4000.

Troubleshooting

  1. If port conflicts occur, use `--port 5555` to specify a different port.
  2. If using asdf and having MCP issues, set a global Node.js version from home directory (`asdf set nodejs x.x.x`).
  3. Ensure Node.js version is v20.0.0 or higher.
  4. If diagrams are not showing, check local web app at `http://localhost:4000` (or custom port).
  5. For development, run Claude with `--debug` flag to see MCP errors.

Things to try

Once connected, you can ask your AI assistant things like:

  • Create a C4 context diagram of this project's architecture.
  • Show me the state machine for WebSocket connection logic.
  • Show me the OAuth flow as a sequence diagram.

Use cases

Visualize the architecture of legacy codebases to quickly understand the system.
Generate a C4 context diagram of a project's architecture.
Show OAuth flow as a sequence diagram.
Inspect state machine for WebSocket connection logic.
Identify unused and redundant constructs in AI-generated code.

Supported clients

Claude Desktop
VS Code
Cursor
Windsurf
Zed

Listed from the project's documentation, not tested by this site.

Overview

Mindpilot MCP is an MCP server for generating and rendering Mermaid diagrams. It enables your AI coding assistant to create on-demand architecture, code, and process diagrams displayed in a local web app, allowing you to visually explore and understand codebases. All diagrams are processed locally and never sent to the cloud. It supports multiple clients sharing the same diagram collection and exporting diagrams as vector images.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 63.3k · Tools 2 Compare with this →
Compare with other MCP servers

Source revision c74c5acf2343 Data synced 2026-10-19 Read the FMRS scoring method