MCP Diagram Server 📊

A powerful Model Context Protocol (MCP) server for creating, manipulating, and managing Mermaid diagrams with automatic saving and integrated multi-format support. Built with enterprise-grade persistence and designed for seamless AI workflow integration.

🌟 Key Features

🔄 Automatic Saving & Library System

• Auto-save on creation/modification - Never lose your work
• Persistent diagram library stored in /diagrams directory
• Metadata tracking with creation/modification timestamps
• Instant load from disk - Diagrams persist across sessions

📁 Integrated Multi-Format Support

• JSON → Flowcharts (hierarchical structure visualization)
• CSV → Organizational/Relationship charts
• Python Code → Class diagrams (automatic AST parsing)
• Markdown → Mind maps (hierarchical content mapping)
• Plain Text → Structured diagrams (with indentation detection)

🎨 Rich Diagram Types

• Flowcharts - Process flows and decision trees
• Sequence Diagrams - Interaction sequences
• Mind Maps - Concept organization and brainstorming
• Gantt Charts - Project timelines and scheduling
• Class Diagrams - Object-oriented system design
• Entity Relationship - Database schema visualization
• User Journey Maps - Experience flow mapping
• Git Graphs - Version control visualization
• Pie Charts - Data visualization
• State Diagrams - State machine modeling

🛠 Professional Tools

• Template Library with 8+ pre-built diagram templates
• Custom save locations in addition to auto-saving
• Smart format detection with conversion recommendations
• Resource access for MCP integration
• Background processing with robust task management

Note: If there is a syntax error converting a diagram remove any () in the underlined code error.

🚀 Quick Start- Simply clone the repository and add the following

Claude Desktop Configuration

Add to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "diagram-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/your-path-to/mcp-diagram-server",
        "run",
        "main.py"
      ],
      "env": {
        "LOG_LEVEL": "INFO"
      }
    }
  }
}

Installation- will auto-install with config

1. Clone the repository:

cd /mcp-diagram-server

2. Set up the Python environment:

uv venv --python 3.12 --seed
source .venv/bin/activate
uv add -e .

3. Optional - Install Playwright for rendering:

uv add playwright
uv run playwright install chromium

📚 Available MCP Tools

Core Diagram Operations

• create_diagram - Create new diagrams with optional templates
• update_diagram - Modify existing diagram content (auto-saves)
• get_diagram - Retrieve diagrams from memory or disk
• list_diagrams - Browse your diagram library
• delete_diagram - Remove diagrams from memory

Format Conversion Tools

• convert_format_to_diagram - Universal format converter with auto-detection
• json_to_flowchart - Convert JSON structures to flowcharts
• csv_to_org_chart - Convert CSV data to organizational/relationship charts
• python_to_class_diagram - Convert Python code to class diagrams
• markdown_to_mindmap - Convert structured markdown to mind maps
• detect_file_format - Smart format detection with conversion recommendations

Library Management

• save_diagram - Manual save to custom locations
• list_templates - Browse available diagram templates
• Auto-saving - Automatic persistence (always active)

💡 Usage Examples

Universal Format Conversion

convert_format_to_diagram(
    content='{"api": {"users": ["get", "post"], "orders": ["get", "create"]}}',
    target_type="flowchart",
    name="APIStructure"
)

Result: Auto-saved flowchart showing API structure hie

... View full README on GitHub