Mindpilot

See through your agent's eyes. Visualize legacy code, architect new systems, understand everything.

typescript

75

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

Mindpilot MCP lets you run a local diagram server that renders Mermaid diagrams from your agent-driven requests. It keeps processing on your machine, supports multiple assistants, and lets you visualize architecture, flows, and code interactions without sending diagrams to the cloud.

How to use

You enable Mindpilot MCP in your coding agent, then ask your agent to create diagrams like a state machine, a C4 context diagram, or an OAuth flow. The server renders Mermaid syntax in a browser connected to the MCP server. You can work with multiple assistants at once, and all see the same diagram history and interface.

How to install

Prerequisites you need before starting:

Node.js v20.0.0 or higher

Install and run the MCP server using your preferred client. The examples below show common integration methods. Each approach runs the MCP server locally via npx and connects your client to it.

Claude Code setup

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

VS Code setup

Open your settings and configure the MCP server to be used by the editor.

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

Windsurf setup

Configure Mindpilot in Windsurf to expose an MCP server for your projects.

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

Zed setup

Add a custom server in the AI Thread panel and point it to Mindpilot MCP.

Command to run MCPserver: npx @mindpilot/mcp@latest

Configuration options

You can customize where the server runs and where diagrams are stored.

Port: The server defaults to port 4000. Use --port to change it.
Data path: Diagrams are saved by default to ~/.mindpilot/data/. Use --data-path to specify a custom location.

Available tools

renderMermaidDiagrams

Renders Mermaid diagrams from text prompts and Mermaid syntax in a web interface exposed by the MCP server.

exportDiagram

Exports any rendered diagram as a vector image for sharing or documentation.

multiClientSessionManagement

Coordinates multiple MCP clients to share a single diagram history and web interface, automatically handling connections and disconnections.