Mermaid MCP Server

@andrewginns

代码仓库

基本信息

分类

其他

传输方式

stdio

作者

andrewginns

关于 Mermaid MCP Server

Python MCP Server abstracting the official mermaid-cli for ease of use

#mermaid #mcp-server#diagram-validation

Mermaid MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mermaid-mcp-server-andrewginns": {
      "command": "npx",
      "args": [
        "@mermaid-js/mermaid-cli",
        "--version"
      ]
    }
  }
}

Mermaid MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

点击上方按钮,在临时沙箱中运行此服务器并实时获取工具列表。

概览

What is Mermaid MCP Server?

Mermaid MCP Server is a Model Context Protocol (MCP) server that validates Mermaid diagram syntax and optionally renders them as PNG images. It wraps the Mermaid CLI tool to provide LLMs with structured validation results, including boolean status, detailed error messages, and optional base64‑encoded images. Designed for developers integrating diagram validation into AI workflows.

How to use Mermaid MCP Server?

Configure the server in your MCP client (e.g., Claude Desktop) using uv and the provided Python script. The server exposes a single tool validate_mermaid_diagram that accepts diagram_text (required) and return_image (optional, default false). Example configuration JSON is included in the README, and local testing can be done via make install and make test.

Key features of Mermaid MCP Server

Validates Mermaid diagram syntax with structured error messages
Optionally returns base64-encoded PNG images of diagrams
Manages temporary files, puppeteer config, and command construction automatically
Context‑length optimised (images disabled by default)
Supports standard stdio transport for MCP clients
Includes a Pydantic AI test client using Gemini models

Use cases of Mermaid MCP Server

AI‑powered diagramming assistants that validate user‑provided Mermaid syntax
Automated documentation pipelines that verify diagram correctness before rendering
LLM agents that need to generate and visually confirm Mermaid diagrams

常见问题

What does the server validate?

It validates Mermaid diagram syntax using the Mermaid CLI. Returns `is_valid: true/false` and a detailed error message if validation fails.

What are the runtime dependencies?

Node.js with npm, Mermaid CLI (`npm install -g @mermaid-js/mermaid-cli`), and Python with `uv`. All are required even if only using the server component.

Why does the tool not return an image by default?

Returning images (base64 strings) can consume significant LLM context length (10KB–100KB+). Disabling images by default preserves context for longer conversations.

How are temporary files handled?

The server automatically creates and cleans up temporary `.mmd` and `.png` files, generates puppeteer configuration, and manages subprocess commands. No manual file management is needed.

Can I test the server locally?

Yes. Use `make install` to set up dependencies and `make test` to run validation tests. A test script using Pydantic AI with Gemini models is also provided.

其他分类下的更多 MCP 服务器

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40