Log inSubmit server
Mindpilot MCP logo

Mindpilot MCP

by abrinsmead

Generates Mermaid diagrams from agent requests and displays them in a local web app with export and persistent history.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Mindpilot MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "abrinsmead-mindpilot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mindpilot/mcp@latest"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

The install command started, but didn't respond the way we expected when we tried to talk to it.

npx -y @mindpilot/mcp@latest

initialize succeeded but no response to tools/list.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

abrinsmead/mindpilot-mcp MCP server accepts Mermaid diagram syntax from an AI coding agent and renders the result in a locally hosted web app. Use it to visualize code, architecture, state machines, process flows, and OAuth sequences. Diagrams are stored locally, with a default web address of http://localhost:4000 and a configurable port and data path. It fits development workflows where visual inspection can clarify legacy code or complex logic.

Use cases

  • Visualize legacy code structure
  • Map WebSocket connection states
  • Create C4 architecture diagrams
  • Illustrate OAuth request flows
  • Inspect process logic visually

Key features

  • Renders Mermaid diagrams in a local web app
  • Supports configurable port and data path
  • Stores diagram history locally
  • Shares one server across multiple MCP clients
  • Exports diagrams as vector images
  • Supports disabling anonymous analytics

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

21/21 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 2d ago via OSV.dev · @mindpilot/mcp@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars90Stargazers on the source repository.
npm downloads77Package downloads in the last 30 days.
Last commit3mo agoMost recent push to the default branch.
Install checkInconclusiveStarted but did not complete the MCP handshake in our test.
Directory activity7 viewsConfig copies, upvotes, and views on AllMCPs.

How Mindpilot MCP works

What abrinsmead/mindpilot-mcp MCP server does

abrinsmead/mindpilot-mcp MCP server connects an AI coding agent to a local Mermaid diagram viewer. The agent can turn requests about source code, architecture, or processes into Mermaid syntax, which the server renders in a browser-based interface. Example uses include mapping WebSocket connection states, creating a C4 context diagram, and illustrating an OAuth sequence.

The project is intended for interactive analysis rather than remote diagram hosting. Its local processing model keeps diagrams on the local machine instead of sending them to a separate diagram service. The diagrams can also be exported as vector images.

How it works

The MCP process receives Mermaid syntax generated by the agent and serves the rendered diagrams through a local web application. The default interface is available at http://localhost:4000. The server saves diagram data under ~/.mindpilot/data/ unless a different location is provided.

Multiple MCP clients can use the same running instance. The first client starts the shared web server; later clients connect to it and use the same history and browser interface. After the final MCP client disconnects, the server shuts down after approximately one minute.

Setup and configuration

abrinsmead/mindpilot-mcp MCP server requires Node.js 20 or newer. Install it as a local stdio MCP process with the @mindpilot/mcp npm package:

Terminal
npx -y @mindpilot/mcp@latest

Claude Code, Cursor, Windsurf, and other MCP-capable clients can launch the process with npx and the package name. Configuration examples in the project also cover VS Code and Zed. The exact configuration format depends on the host client.

Use --port to change the web server port, such as --port 5555 when port 4000 is already occupied. Use --data-path to choose another directory for saved diagrams. The --disable-analytics flag turns off the anonymous usage tracking described by the project.

Tools and capabilities

The server supports agent-directed diagram generation for subjects such as:

  • Code structure and legacy code
  • System and software architecture
  • State machines
  • Process flows
  • OAuth flows
  • C4 context diagrams

The resulting Mermaid diagrams are displayed in the local web interface and can be exported as vector images. Persistent diagram history is shared among concurrently connected MCP clients.

Limitations and notes

The server depends on a local Node.js runtime and browser access to its local web application. It does not describe a hosted endpoint or a cloud storage service. Diagram quality depends on the Mermaid syntax produced by the connected language model; the MCP server is described as accepting and rendering that syntax rather than generating the underlying analysis itself.

Add --disable-analytics to the MCP arguments if that collection is not desired. A custom data path can support local synchronization workflows, but the project does not document a built-in synchronization provider.

The README also points to a separate Mermaid viewer agent skill that does not require a local MCP server. That alternative is distinct from abrinsmead/mindpilot-mcp MCP server.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Mindpilot MCP

Use Node.js 20 or newer and run `npx -y @mindpilot/mcp@latest`, then add that stdio command to your MCP client configuration.

Yes. The README provides Cursor configuration using `npx` with `@mindpilot/mcp@latest`.

Pass the `--port` command-line option, for example `--port 5555`, in the MCP configuration.

By default, diagrams are saved in `~/.mindpilot/data/`. Use `--data-path` to select another directory.

Add the `--disable-analytics` flag to the server arguments.

Related MCP servers

All in Data Visualization All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMindpilot MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/abrinsmead-mindpilot-mcp?style=directory)](https://allmcps.com/mcp/abrinsmead-mindpilot-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/abrinsmead-mindpilot-mcp"><img src="https://allmcps.com/api/badge/abrinsmead-mindpilot-mcp?style=directory" alt="Mindpilot MCP on AllMCPs" /></a>