Diagram Bridge Mcp

What is Diagram Bridge Mcp?

Diagram Bridge Mcp is an MCP server that bridges LLMs and diagram creation through three independent tools: intelligent format selection (help_choose_diagram), format-specific instruction generation (get_diagram_instructions), and professional diagram rendering via a local Kroki service. It supports formats including Mermaid, PlantUML, C4 Model, D2, GraphViz, BPMN, Structurizr, Excalidraw, and Vega-Lite. Designed for developers using MCP clients (e.g., Cursor) who need LLMs to produce diagrams without manual format or rendering decisions.

How to use Diagram Bridge Mcp?

Install Node.js 18+, clone the repo, run npm install && npm run build, then start services with docker-compose up --build. Configure your MCP client to point to the built dist/index.js file. The server automatically provides three tools (help_choose_diagram, get_diagram_instructions, render_diagram) that can be used standalone or in sequence.

Key features of Diagram Bridge Mcp

• Tool for intelligent diagram format selection with confidence scoring
• Generates format-specific coding instructions and syntax guidelines
• Renders diagram code to PNG/SVG via integrated local Kroki service
• Supports nine popular diagram formats out of the box
• Includes caching for performance and file storage with absolute paths

Use cases of Diagram Bridge Mcp

• Choosing the optimal diagram format for visualizing architecture, relationships, or workflows
• Guiding LLMs to generate syntactically correct diagram code for a specific format
• Rendering diagram code into professional images for documentation or reports

FAQ from Diagram Bridge Mcp

What are the prerequisites for running the server?

You need Node.js 18.0 or higher and Docker with Docker Compose.

How do I configure the output storage location?

By default, rendered diagrams are saved to {project-root}/generated-diagrams/. Advanced configuration is described in the configuration guide.

What diagram formats are supported?

The server supports Mermaid, PlantUML, C4 Model, D2, GraphViz, BPMN, Structurizr, Excalidraw, and Vega-Lite.

Does the server require an internet connection?

No. Rendering uses a local Kroki service started via Docker Compose, so all processing happens locally.

How do I add this server to Cursor?

Add a JSON entry to your MCP client configuration with command: "node" and args: ["/path/to/dist/index.js"] as shown in the README.