Mermaid MCP Server (mcp-mermaid)

Mermaid 다이어그램 텍스트 코드를 입력받아, 마크다운이나 웹에서 즉시 볼 수 있는 정적 이미지(URL 및 Base64)로 변환해 주는 Model Context Protocol (MCP) 서버입니다.

기능 (MCP Tools)

• mermaid_generate_url: Mermaid 다이어그램 텍스트를 입력받아 브라우저나 마크다운에서 볼 수 있는 단축 URL 반환
• mermaid_generate_base64: 차트 이미지를 Base64 인코딩된 데이터 URI 형태로 직접 반환

참고: 모든 도구와 파라미터에 대한 설명은 LLM이 맥락을 완벽히 이해할 수 있도록 한국어(KR)와 영어(EN) 이중 언어로 기재되어 있습니다.

환경 변수

• MERMAID_INK_URL: 이미지 렌더링에 사용할 Mermaid Ink 서버 URL. 사내 전용 서버 구축 시 변경 (기본값: https://mermaid.ink)
• NODE_TLS_REJECT_UNAUTHORIZED: 사설 인증서 사용 시 0으로 설정 (기본값: 0)
• PORT: HTTP 서버 포트 (기본값: 3000)
• TRANSPORT: http 또는 sse 설정 시 HTTP 서버로 구동 (미설정 시 stdio)

실행 방법

로컬 실행 (npx)

{
  "mcpServers": {
    "mermaid-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-mermaid"],
      "env": {
        "MERMAID_INK_URL": "https://mermaid.ink"
      }
    }
  }
}

Docker 실행 (HTTP / SSE)

cp .env.example .env
docker-compose up -d --build

이후 http://localhost:3000/mcp 엔드포인트를 통해 접근할 수 있습니다.