Gemini-cli mindpilot-mcp

Forked from original repository:

See through your agent's eyes. Visualize legacy code, inspect complex flows, understand everything.

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.

• Edit: This package is used as gemini-cli mcp.

Prerequisites

Node.js v20.0.0 or higher.

Quickstart

Gemini-cli:

In the .gemini\settings.json

    "mindpilot": {
      "command": "npx",
      "args": [
        "gemini-cli-mindpilot",
        "--disable-analytics",
        "--port",
        "8931"
      ]
    },

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.

Using the MCP server

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.

Example requests

• "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"

Troubleshooting

Port Conflicts

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

Custom Data Path

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

Other IDEs:

{
  "command": "npx",
  "args": ["@mindpilot/mcp@latest", "--data-path", "/path/to/custom/location"]
}