Sargoth Mermaid Renderer - MCP Server

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

@floor-licker

リポジトリ

Sargoth Mermaid Renderer - MCP Server について

MCP Server for the Sargoth Mermaid Editor API

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

基本情報

カテゴリ

その他

ライセンス

MIT license

ランタイム

python

トランスポート

stdio

公開者

floor-licker

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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.