MCP server for generating Mermaid diagrams with live browser preview
The mermaid-live-mcp server exposes 4 tools with basic structure but significant definition quality gaps. Tool names follow verb_noun convention (generate_, update_, list_, export_), but descriptions are adequate to good (120 - 150 chars), falling in the middle of the 194-char production baseline. Critical gap: INPUT SCHEMAS are not visible in the provided source code. The packages/mcp-server/src/index.ts file is truncated, and no explicit schema registration is shown. Parameter descriptions are present in the JSON schema snippets (syntax, diagram_id, path), but the actual tool registration code is not shown, making it impossible to verify JSON Schema structure, type declarations, or constraints. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) are present. Output schemas are not documented. The server is feature-complete for a lightweight diagram tool but falls short of production-grade definition quality.
Write a diagram's SVG to disk. PNG export is available via the browser download buttons.
Generate a diagram from Mermaid.js syntax. Renders in live preview browser with SVG/PNG download options. Supports flowcharts, sequence diagrams, class diagrams, state diagrams, ER diagrams, Gantt charts, and more.
List all diagrams generated in this session.
Replace a diagram's Mermaid syntax and re-render it in the preview.
Input schemas not visible in source code. Cannot verify JSON Schema structure, type constraints, enums, or parameter validation.
Tool definitions appear inferred from JSON snippets, not directly visible in source code. The packages/mcp-server/src/index.ts file is truncated.
No tool annotations present. Tools lacking readOnlyHint/destructiveHint/idempotentHint prevent LLM from inferring retry safety. update_diagram and export_diagram are WRITE operations but unmarked.
Output schemas not documented. LLMs cannot predict what fields generate_mermaid, list_diagrams, or export_diagram will return. Blocks downstream tool chaining and context planning.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-21 | F | 38 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 43 | - | v1 |
list_diagrams has no parameters but description is vague ('List all diagrams generated in this session'). Does not explain what fields are returned or pagination limits.
No error recovery guidance. errorReporting=true but no visible error categorization (retryable vs user-fixable vs fatal) or recovery hints in implementation.
Missing parameter constraints. 'syntax' parameter accepts free-form string with no documented Mermaid syntax validation, examples of valid inputs, or error handling for invalid syntax.
export_diagram path parameter has no documented format constraints. Unclear if it requires absolute vs relative paths, file extension handling, or directory traversal protections.