Skip to main content
Glama

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의 모든 기능과 구문을 완벽하게 지원합니다.

  • backgroundColortheme 설정을 지원하여 대규모 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.

Install Server
A
license - permissive license
B
quality
C
maintenance

Maintenance

Maintainers
31dResponse time
4wRelease cycle
6Releases (12mo)
Commit activity
Issues opened vs closed

Related MCP Servers

  • 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.
    51
  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that enables AI assistants to programmatically create and manage flowcharts, ERDs, and swimlane diagrams. It provides tools for manipulating diagram structures, performing auto-layouts, and exporting to Mermaid or Markdown formats.
    14
    MIT

View all related MCP servers

Related MCP Connectors

  • AI agent draws editable hand-drawn diagrams (flowchart, ER, architecture) via MCP, not static images

  • Let Claude, Cursor, or ChatGPT author Mermaid diagrams your team can read and share.

  • Generate cloud architecture diagrams, flowcharts, and sequence diagrams.

View all MCP Connectors

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