Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"mermaid-editor": {
"args": [
"--mcp"
],
"command": "/path/to/mermaid-editor"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
AI-agent-focused Mermaid editor for planning, with built-in MCP server and CLI tool
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y 'esbuild' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
esbuild enables any website to send any requests to the development server and read the response
### Summary esbuild allows any websites to send any request to the development server and read the response due to default CORS settings. ### Details esbuild sets `Access-Control-Allow-Origin: *` header to all requests, including the SSE connection, which allows any websites to send any request to the development server and read the response. https://github.com/evanw/esbuild/blob/df815ac27b84f8b34374c9182a93c94718f8a630/pkg/api/serve_other.go#L121 https://github.com/evanw/esbuild/blob/df815a
Click any tool to inspect its schema.
This server is missing a description.If you've used it, help the community.
Add informationBe the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in developer-tools
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
MCP server for using the GitLab API
MCP server for accessing Figma plugin console logs and screenshots via Cloudflare Workers or local mode
MCP Security Weekly
Get CVE alerts and security updates for MermAId and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
A local Mermaid diagram editor designed for AI-assisted workflows. It's a pretty nice live Mermaid editor. But it's also a tool to be used with AI coding agents in generating plans. An AI coding agent (Claude Code, Codex, etc.) generates or updates diagrams via MCP or CLI, and you see the results rendered live in your browser. You can also edit diagrams directly — it's a full editor with syntax highlighting, linting, and vim keybindings. Push changes back to the agent, iterate, rinse and repeat.
The editor runs as a small Go server on localhost with a split-pane UI: a CodeMirror text editor on the left and a live Mermaid preview on the right.
AI agents interact with the editor via MCP or CLI to generate and update diagrams programmatically.

The native macOS app bundle is a self-contained executable that lives in the Dock and is freestanding (including the MCP server).
.app bundle with a menu-bar icon (tray app)git clone https://github.com/kmatthias/mermaid-editor.git
cd mermaid-editor
make build
This installs JS dependencies, bundles the frontend, and compiles the Go
binary. The resulting binary is ./mermaid-editor — static assets are embedded
at compile time, so the single file is all you need.
On macOS, the build uses CGO to link against Cocoa and WebKit for the native app window. On Linux, no CGO or system libraries are required.
Windows requires Go and Node.js installed. If you have GNU Make (e.g. via Chocolatey, MSYS2, or Git Bash):
make build
Without Make, run the steps manually in PowerShell:
npm install
npx esbuild frontend/app.js --bundle --format=iife --minify --sourcemap --outfile=static/bundle.js
copy frontend\style.css static\style.css
go build -o mermaid-editor.exe .
# macOS / Linux: copy the binary somewhere on your PATH
cp mermaid-editor /usr/local/bin/
# Or use go install on any platform (requires GOBIN on PATH)
go install .
On Windows, copy mermaid-editor.exe to a directory on your %PATH%, or use go install ..
# Run the editor (opens in your default browser)
./mermaid-editor
# Run in development mode with live JS rebuilds
make dev
The editor opens automatically in your default browser. If an instance is already running, it focuses the existing window instead of starting a new one.
| macOS | Linux | Windows | |
|---|---|---|---|
| Browser | Opens via open | Opens via xdg-open | Opens via rundll32 |
| Native window | Yes (Cocoa/WebKit app) | No — browser only | No — browser only |
| App bundle | make macapp | N/A | N/A |
| CGO required | Yes (for native window) | No | No |
make macapp
Creates MermAId Editor.app, a self-contained macOS applica