mcp-server

mermaid-mcp-server

Name: mermaid-mcp-server
Author: peng-shawn

A Model Context Protocol (MCP) server that converts Mermaid diagrams to PNG images

235 stars22 forksJavaScriptUpdated 10/22/2026100% free · open source

What it does

Runs a local HTTP server that turns Mermaid diagram code into PNG images via a simple API.

When to use it

•You need to generate diagram images on‑the‑fly for reports, emails, or product docs.
•Your CI/CD pipeline must render Mermaid charts without installing heavy GUI tools.
•You want a cheap, self‑hosted alternative to SaaS diagram‑as‑a‑service for your internal tools.

Ready-to-paste prompt

curl -X POST http://localhost:3000/render -H "Content-Type: application/json" -d '{"code":"flowchart TD\n    Start-->Decision{Is it working?}\n    Decision--Yes-->End\n    Decision--No-->Fix[Fix the bug]\n    Fix-->Start"}' --output bugflow.png

Heads up: The server requires Node ≥14; if you run `node -v` and see an older version, upgrade first or the server will crash at start‑up.

Saves to your device

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

✅ Light setup

Installs with a command or two; your AI agent can do it for you.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/mermaid-mcp-server && curl -fsSL https://workflowstacks.com/api/skills/mermaid-mcp-server/claude-skill -o ~/.claude/skills/mermaid-mcp-server/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How mermaid-mcp-server works

Codeflow

Free to inspect

Mermaid-mcp-server is a small TypeScript project (~750 lines across 2 code files). Setup is light: installs like a normal app. Reading the code is optional. Last commit this month, MIT license, no tests found.

Size

Small codebase

~750 lines · 2 code files · 6 min skim

Setup

One-command install

Installs like a normal app. Reading the code is optional.

Runs on

Node.js · Docker

No API keys detected

TypeScript 80%Shell 17%Dockerfile 3%

Where to start reading

1
README.md
Start here — what it does and how to install it
2
index.ts
Where the program starts running
3
package.json
Dependencies and the commands it exposes

What's in each folder

diagrams/Folder3 files

scripts/Helper scripts1 files

.github/CI / automation (GitHub Actions)1 files

READMENo tests foundThin docsCI checksDocker readyMIT licenseUpdated this month

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

✅ Light setup

Installs with a command or two; your AI agent can do it for you.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/mermaid-mcp-server && curl -fsSL https://workflowstacks.com/api/skills/mermaid-mcp-server/claude-skill -o ~/.claude/skills/mermaid-mcp-server/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

Quick Actions

Details

Creator

peng-shawn

Language

JavaScript