Skip to main content
Glama
deenesjakoruzh
hustcc

MCP Server Mermaid

by hustcc
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

MCP Mermaid build npm Version npm License Trust Score

AI MCP를 사용하여 mermaid 다이어그램과 차트를 동적으로 생성합니다. 다음 도구들도 함께 사용할 수 있습니다:

  • mcp-server-chart: 차트, 그래프, 지도를 생성합니다.

  • Infographic: Timeline, Comparison, List, Process 등 인포그래픽을 생성합니다.

  • 🖼️ figure.ling.pub/gallery: mcp-mermaid 및 기타 도구로 생성된 AI 다이어그램과 그림을 탐색하고 공유합니다.

✨ 주요 기능

  • Mermaid의 모든 기능과 구문을 완벽하게 지원합니다.

  • backgroundColor 및 theme 설정을 지원하여 대규모 AI 모델이 풍부한 스타일 구성을 출력할 수 있도록 합니다.

  • base64, svg, mermaid, file 및 원격 공유가 가능한 svg_url, png_url 형식으로 내보내기를 지원하며, 모델이 다회차 출력 시 올바른 구문과 그래픽을 생성할 수 있도록 Mermaid 유효성 검사를 제공합니다. outputType: "file"을 사용하여 AI 에이전트를 위해 PNG 다이어그램을 디스크에 자동으로 저장하거나, URL 모드를 사용하여 공개 mermaid.ink 링크를 통해 다이어그램을 공유할 수 있습니다.

Related MCP server: Mermaid-MCP

🤖 사용 방법

Claude, VSCode, Cline, Cherry Studio 등 Desktop APP과 함께 사용하려면 아래 MCP 서버 설정을 추가하세요. Mac 시스템의 경우:

{
  "mcpServers": {
    "mcp-mermaid": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mermaid"
      ]
    }
  }
}

Windows 시스템의 경우:

{
  "mcpServers": {
    "mcp-mermaid": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "mcp-mermaid"
      ]
    }
  }
}

또한, HTTP 및 SSE 프로토콜을 지원하는 aliyun, modelscope, glama.ai, smithery.ai 등에서도 사용할 수 있습니다.

접속 지점:

  • SSE: http://localhost:3033/sse

  • Streamable: http://localhost:1122/mcp

사용 가능한 Docker 태그:

  • susuperli/mcp-mermaid:latest - 최신 안정 버전

  • Docker Hub에서 모든 사용 가능한 태그 확인

🚰 SSE 또는 Streamable 전송으로 실행

옵션 1: 전역 설치

패키지를 전역으로 설치합니다:

npm install -g mcp-mermaid

원하는 전송 옵션으로 서버를 실행합니다:

# For SSE transport (default endpoint: /sse)
mcp-mermaid -t sse

# For Streamable transport with custom endpoint
mcp-mermaid -t streamable

옵션 2: 로컬 개발

소스 코드를 로컬에서 작업하는 경우:

# Clone and setup
git clone https://github.com/hustcc/mcp-mermaid.git
cd mcp-mermaid
npm install
npm run build

# Run with npm scripts
npm run start:sse        # SSE transport on port 3033
npm run start:streamable # Streamable transport on port 1122

접속 지점

다음 주소에서 서버에 접속할 수 있습니다:

  • SSE 전송: http://localhost:3033/sse

  • Streamable 전송: http://localhost:1122/mcp (로컬) 또는 http://localhost:3033/mcp (전역)

🎮 CLI 옵션

MCP 서버 실행 시 다음 CLI 옵션을 사용할 수 있습니다. -h를 사용하여 CLI를 실행하면 명령어 옵션을 확인할 수 있습니다.

MCP Mermaid CLI

Options:
  --transport, -t  Specify the transport protocol: "stdio", "sse", or "streamable" (default: "stdio")
  --port, -p       Specify the port for SSE or streamable transport (default: 3033)
  --endpoint, -e   Specify the endpoint for the transport:
                    - For SSE: default is "/sse"
                    - For streamable: default is "/mcp"
  --help, -h       Show this help message

🔨 개발

의존성 설치:

npm install

서버 빌드:

npm run build

MCP 서버 시작

MCP Inspector 사용 (디버깅용):

npm run start

다른 전송 프로토콜 사용:

# SSE transport (Server-Sent Events)
npm run start:sse

# Streamable HTTP transport
npm run start:streamable

직접 노드 명령어 사용:

# SSE transport on port 3033
node build/index.js --transport sse --port 3033

# Streamable HTTP transport on port 1122
node build/index.js --transport streamable --port 1122

# STDIO transport (for MCP client integration)
node build/index.js --transport stdio

🐳 Docker 사용법

Docker로 MCP Mermaid 실행:

# Pull the image
docker pull susuperli/mcp-mermaid:latest

# Run with SSE transport (default)
docker run -p 3033:3033 susuperli/mcp-mermaid:latest --transport sse

# Run with streamable transport
docker run -p 1122:1122 susuperli/mcp-mermaid:latest --transport streamable --port 1122

📄 라이선스

MIT@hustcc.

Available Tools

1 tool
generate_mermaid_diagramBInspect

Generate mermaid diagram and chart with mermaid syntax dynamically. Mermaid is a JavaScript based diagramming and charting tool that uses Markdown-inspired text definitions and a renderer to create and modify complex diagrams. The main purpose of Mermaid is to help documentation catch up with development.

ParametersJSON Schema
NameRequiredDescriptionDefault
mermaidYesThe mermaid diagram syntax used to be generated, such as, graph TD; A-->B; A-->C; B-->D; C-->D;.
themeNoTheme for the diagram (optional). Default is 'default'.default
backgroundColorNoBackground color for the diagram (optional). Default is 'white'.white
outputTypeNoThe output type of the diagram. Can be 'base64', 'svg', 'mermaid', 'file', 'svg_url', or 'png_url'. Default is 'base64'. 'base64' returns PNG image as base64 encoded string. 'file' saves the PNG image to disk. The *_url options return public mermaid.ink links for remote-friendly sharing.base64

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description fails to disclose behavioral traits such as side effects, performance, or limitations. It only broadly states dynamic generation without specifics.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise with two sentences, but the second sentence focuses on Mermaid's general purpose rather than the tool's specific behavior. No filler words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description does not explain the output format or how to use the returned data. With no output schema, relying on the outputType parameter is insufficient for complete understanding.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage, so the parameters are already well-documented. The description adds no additional meaning beyond what the schema provides.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: generating mermaid diagrams and charts dynamically. It explains what Mermaid is, providing context for the tool's functionality.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool or when not to use it. There are no alternatives mentioned, and the description lacks explicit usage context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

TDQS

B3.4/5.0
Disambiguation5/5

With only one tool, there is no possibility of confusion between tools. The tool's purpose is clear and stands alone.

Naming Consistency5/5

Since there is only one tool, naming consistency is not applicable, but the single name follows a clear descriptive pattern.

Tool Count3/5

A single tool for generating Mermaid diagrams is minimal. While it covers the core functionality, the scope feels thin (1 tool) compared to typical MCP servers that handle diagramming workflows.

Completeness3/5

The tool covers the primary task of generating diagrams, but lacks auxiliary operations such as validation, styling, or export options that would enhance completeness for a diagramming server.

Maintenance

ActivityInactive
ResponsivenessSlow

Resources

Related MCP Connectors

Related MCP Servers

  • mcp-mermiad

    Narasimhaponnada
    F
    license
    Not graded
    quality
    F
    maintenance
    Narasimhaponnada/mermaid-mcp - AI-powered Mermaid diagram generation with 22+ diagram types including flowcharts, sequence diagrams, class diagrams, ER diagrams, architecture diagrams, state machines, and more. Features 50+ pre-built templates, advanced layout engines, SVG/PNG/PDF exports.
    52

  • diagrams-mcp

    nacho-mazzoni
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables automatic generation of UML class diagrams and entity-relationship diagrams from natural language descriptions or structured JSON data. It integrates with MCP agents to create visual representations of code structures and system designs without manual Mermaid coding.
    15
    1
    MIT

Appeared in Searches

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/hustcc/mcp-mermaid'

If you have feedback or need assistance with the MCP directory API, please join our Discord server