Sargoth Mermaid Renderer - MCP Server

Name: Sargoth Mermaid Renderer - MCP Server
Author: floor-licker

@floor-licker

Repository

About Sargoth Mermaid Renderer - MCP Server

MCP Server for the Sargoth Mermaid Editor API

#chart #diagram #mermaid #diagram-editor #diagram-generator

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "sargoth-mcp": {
      "command": "python",
      "args": [
        "mcp_server.py"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Sargoth Mermaid Renderer - MCP Server?

An MCP (Model Context Protocol) server that lets AI assistants like Claude Desktop generate, validate, and improve Mermaid diagrams. It connects to the free Sargoth.xyz Mermaid rendering API, requiring no account or setup, and is aimed at users who want to create professional SVG/PNG diagrams from natural‑language descriptions during AI conversations.

How to use Sargoth Mermaid Renderer - MCP Server?

Install Python 3.8+, run pip install -r requirements.txt, make mcp_server.py executable, and test with python mcp_server.py. For integration with Claude Desktop, add the server’s absolute path and command to the claude_desktop_config.json file; other MCP clients use a similar JSON configuration.

Key features of Sargoth Mermaid Renderer - MCP Server

Render Mermaid code as SVG (render_mermaid_svg)
Render Mermaid code as PNG with scaling (render_mermaid_png)
Validate Mermaid syntax and analyze complexity (validate_mermaid)
Suggest improvements for Mermaid code (suggest_mermaid_improvements)
Supports four themes: modern, classic, dark, minimal
Defaults to production API at sargoth.xyz; local development supported

Use cases of Sargoth Mermaid Renderer - MCP Server

Creating flowcharts, sequence diagrams, or state diagrams in AI conversations
Validating and fixing Mermaid syntax errors interactively
Generating CI/CD pipeline diagrams in SVG or PNG format
Producing educational class diagrams and technical documentation visuals
Batch‑processing multiple diagrams sequentially with AI assistance

FAQ from Sargoth Mermaid Renderer - MCP Server

What dependencies are required?

Python 3.8 or newer and the packages listed in requirements.txt. No account or API key is needed when using the default production endpoint.

How do I configure it with Claude Desktop?

Edit claude_desktop_config.json (location varies by OS) and add an mcpServers entry with command: "python" and args containing the absolute path to mcp_server.py. Restart Claude Desktop afterward.

What themes and output formats are available?

Four themes: modern, classic, dark, minimal. Output formats are SVG (via render_mermaid_svg) and PNG (via render_mermaid_png, with an optional scale factor 1–4, default 2).

Can I run it against a local Mermaid renderer?

Yes. Use the --api-url flag, e.g., python mcp_server.py --api-url http://localhost:5000, after starting your local Mermaid API. The default connects to https://sargoth.xyz.

How does the server handle security and transport?

The production API uses HTTPS. For local development, the server communicates over HTTP on localhost. The server requires outbound HTTPS access to sargoth.xyz when using the default endpoint.