GittyBurstein/mermaid-mcp-server

Overview

A Model Context Protocol server that generates Mermaid diagrams from project source code, supporting both local directories and GitHub repositories. It analyzes code structure and metadata to produce diagrams and renders them using Kroki.

Best for

Best for
Developers seeking to generate code diagrams via MCP-enabled AI assistants

Use cases

• Generate architecture diagrams from a codebase automatically
• Create flowcharts of project workflows for documentation
• Visualize git commit history or dependency graphs

How to use

Install

pip install .[dev]

Tools exposed

• list_files
• read_file
• render_mermaid
• PROJECT_ROOT
• KROKI_BASE_URL
• KROKI_TIMEOUT
• DIAGRAM_OUT_DIR
• MAX_FILE_CHARS
• HTTP_VERIFY
• GITHUB_TOKEN

Tested with

Claude Desktop

Notes

A Model Context Protocol server that generates Mermaid diagrams from project source code, supporting both local directories and GitHub repositories. It analyzes code structure and metadata to produce diagrams and renders them using Kroki.

13 stars on GitHub. Last updated 2026-01-12. Licensed MIT.

Use cases

• Generate architecture diagrams from a codebase automatically
• Create flowcharts of project workflows for documentation
• Visualize git commit history or dependency graphs

Pros

• Integrates with MCP-compatible LLMs for automated diagramming
• Supports both local and remote repositories
• Leverages Kroki for flexible rendering formats

Cons

• Low community adoption (13 GitHub stars)
• Limited documentation and examples
• Requires external Kroki service for rendering

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.