MCP Mermaid

MCP Mermaid

AI MCP を使って、動的に mermaid の図やチャートを生成します。また、以下も利用できます。

• チャート、グラフ、マップを生成する mcp-server-chart。
• Timeline、Comparison、List、Process などのインフォグラフィックを生成する Infographic。
• 🖼️ 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 のリンクから図を共有できます。

🤖 使用方法

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 オプションも使用できます。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

node コマンドを直接使用する：

# 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。